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PREFACE 


This publication describes TESTRAN in 
three sections, one for each of its three 
parts. The description is at a sufficiently 
detailed level to direct the user to the 
portion of the program listing with which 
he is concerned. 


Before using this publication the reader 
should be familiar with the contents of the 
following publications: ; 


IBM System/360 Operating System: : 
Concepts and Facilities, Form C28-6535 


Supervisor and Data Management Services, 
Form C28-6646 


Supervisor and Data Management Macro- 
Instructions, Form C28-6647 


Assembler Language, Form C28-6514 
Linkage Editor, Form C28-6538 


Introduction to Control Program Logic, 
Program Logic Manual, Form Y28-6605 


First Edition 


I This edition applies to release 20.1 of IBM System/360 
Operating System, and to all subsequent releases until 
otherwise indicated in new editions or Technical News- 
letters. Changes are continually made to the specifica- 
tions herein; before using this publication in connection 
with the operation of IBM systems, consult the latest IBM 
System/360 SRL Newsletter, Form N20-0360, for the editions 
that are applicable and current. 


Requests for copies of IBM publications should be made 
to your IBM representative or to the IBM branch office 
serving your locality. 


A form for readers' comments is provided at the back of 
this publication. If the form has been removed, comments 
may be addressed to IBM Corporation, Programming Systems 
Publications, Department D58, PO Box 390, Poughkeepsie, N.Y. 
12602 | 
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The test translator (TESTRAN) is a pro- 
gram testing and debugging aid for IBM 
System/360 Operating System assembler lan- 


guage programmers. 
basic parts: 


° The TESTRAN macro-instructions. 
e The TESTRAN interpreter. 
e The TESTRAN editor. 


Availability of TESTRAN in the operating 
System is determined at system generation 
(SYSGEN) time. Each of the three parts 
functions during a separate job step within 
the operating system. 


The TESTRAN macro-instructions are 
expanded at assembly time from their macro- 
definitions, which are included in the 
system macro-library at SYSGEN. The status 
of the macro-instructions, therefore, is 


that of an expansion of the assembler's. 
macro-instruction library (SYS1.MACLIB). 
When a user writes. TESTRAN - macro- - 
instruction statements, they become input 


to the assembler. 





The TESTRAN interpreter functions in the 





Supervisor state at program execution time. 
Its routines are entered via supervisor 


call (SVC) interruptions and LINK macro-— 
instructions. The individual routines are 
reenterable. They are executed 


"out-of-line" from, but in succession with, 
the problem program. Some of the 
interpreter's routines generate test output 
data. 


The TESTRAN editor prints the problem 
program test output data. Since the editor 
functions after the execution of the 
problem program, it is a "post processor." 
The routines of the editor are serially 
reuseable. the editor is executed as a 
separate job step and is treated the same 
aS any processor by the operating system. 


THE TESTRAN MACRO-INSTRUCTIONS 


_ The TESTRAN macro-instructions are the 
user's means of indicating where testing in 
the problem program is to begin, the exact 
points at which testing is to take place, 
and what tests are to be done. Although 
there are a number of TESTRAN macro- 


instructions, the TEST OPEN, TEST AT, and 


GO BACK macro-instructions assume a special 
Significance. The TEST OPEN 
instruction initiates testing; the TEST AT 


It consists of three 


macro--. . 
routine 


INTRODUCTION 


macro-instruction tells where testing is to 
take place. (These two macro-instructions 
need to be coded: previous to any other 
TESTRAN macro-instructions.) The GO BACK 
macro-instruction is used, either 
explicitly or implicitly, to return control 
to the problem program after a series of 
tests are completed. 


THE TIA TABLE 


The TESTRAN interpreter action (TIA) 
table is constructed from the assemblers 
expansion of the TESTRAN macro- 
instructions, according to their macro- 
definitions which are contained in the 
system macro-library. The table consists _ 


entirely of constants. 





Each macro-instruction entry into the 
TIA table has a specific format. (These 
formats are discussed in detail in Part I 
of this manual.) The entries in the table 
are in the ‘same sequence as the - source 
macro-instructions that caused them to be 
created. Except for the TEST OPEN entry, 
the TIA table is_nonexecutable. 


THE TEST OPEN MACRO-INSTRUCTION 


The TEST OPEN macro-instruction entry is 
always the first entry in the TIA table. 
Although this entry is identical to other 
macro-instruction entries in that it 
contains various constants, the TEST OPEN 
entry has one important distinction. It is 
the only TIA table entry that is executa- 
ble. The first byte of each TIA entry is 
the "type entry" code that is specified in 
the macro-definition; a different value is 
inserted for each of the 23 macro- 
instruction types. Because the type entry 
byte for the TEST OPEN entry is the 
operation code for an SVC instruction, this 
entry is executable. 


THE TEST AT MACRO- INSTRUCTION 


The .TEST AT macro-instruction entry in 
the TIA table indicates where test services 
are to be performed in the problem program. 
At execution time, a TESTRAN interpreter 
inserts SVC instructions into the 


Sealeeenetetianeneee 
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problem program at the places specified in 
the operands of the TEST AT macro- 
instructions. When the problem program is 
executed, the inserted SVC instructions 
cause interruptions that pass control to 
the TESTRAN interpreter which, in turn, 
initiates the performance of the test 
services. 


THE GO BACK MACRO-INSTRUCTION 


The GO BACK macro-instruction entry in 
the TIA table indicates when control is to 
be returned from the TESTRAN interpreter to 
the problem program. Since all testing 
takes place in the supervisor state, it is 
‘necessary to return control to the problem 
state before problem program execution can 
be continued. 


The GO BACK macro-instruction may be 
coded, calling for its functional routine 
explicitly, .or the routine may be called 
for implicitly. Regardless of how control 
is passed to the go back routine, its 
execution allows control to be returned to 
the problem program so that it may resume 
execution. 


THE TESTRAN INTERPRETER 


After assembly, the problem program and 
associated TIA tables must be linkage edit- 
ed into a Single load module. 
module produced is neither reenterable nor 
reuseable. When this load module is speci-. 
fied in an EXEC statement with a TEST 
parameter, the control program prepares the 
job step for execution. 
program and_the_ TESTRAN interpreter rou- 
tines that perform the tests execute under 
control of the “Same “blo 
Thé TESTRAN interpreter ‘routines generate 
test output data for processing and print- 
ing by the TESTRAN editor in a subsequent 
job step. Testing of the problem program 
occurs in succession with the execution of 
the . problem program, but out-of-line from 
it; i.e., the test service routines of the 
interpreter are executed at the points 
within the problem program where the user 
has indicated he wanted them. The request- 
ed series of tests are performed, while the 
problem program execution is temporarily 
suspended, and at the conclusion of the 
series of the test services, problem pro- 
gram execution is resumed. 





location and’ executes it. ~ 


The load 


Both the problem 


~ task control ‘block. 


OPERATION OF THE INTERPRETER 


At problem program execution time, con- 
trol must be passed to the TEST OPEN entry 
in the TIA table to initiate testing. 
Since that entry is an SVC instruction, its 
execution causes an interruption that pass- 
es control to the TESTRAN interpreter. 


The interpreter inserts a TESTRAN SVC 
into the problem program at each point 
specified in the TEST AT macro- 
instructions. The two bytes of the problem 
program displaced by the SVC instruction 
are stored in an interpreter table for 
later retrieval and execution. 


Once the SVC insertions have been made, 
control passes to the entry point specified 
for the problem program, and execution of 
the problem program begins. When an SVC 
instruction is encountered in the problem 
program, the interruption processed for the 
SVC causes control to be passed to the 
interpreter's router routine, which 
determines the TEST AT macro-instruction 
that caused the interruption and analyzes 
the TIA table entry following that TEST AT 
entry. The router then passes control to 
the proper service routine for the perfor- 
Mance of the requested test service. When 
the current series of test requests in the 
TIA table is completed, the router routine 
passes control to the go back routine. The 
go back routine retrieves the two bytes Of 


displaced ‘problem program instruction from 


the “interpreter table where they were 
stored when the TESTRAN SVC was 
reassémbles the instruction at a remote 
control “to the problem program. When the 
problem program terminates, the function of 
the TESTRAN interpreter is completed. 


The test output data, generated as a 
result of the execution of the interpreter 
test service routines is written onto a 
system data set whose ddname is SYSTEST. 
This data is stored for later retrieval and 
editing by the TESTRAN editor. 


THE TESTRAN EDITOR 


The TESTRAN editor transcribes the 
information contained in the test output 
data created by the interpreter into a 
printable output. It is a post processor 


in that it functions only after the problem 


program whose test output it is to edit is 
terminated. The editor consists of dis- 
crete routines that read the test output 
data generated by the TESTRAN interpreter 
and select the records with the proper 
output selection codes for processing. The 


inserted, | 


It then returns 


fo oy 





records are transcribed into the correct 
output format as determined by the type of 
interpreter routine that generated the 
data. Proper headings for the record type 
and available symbolic labels are written 
with the data onto the system print data 
set (SYSPRINT). 


The editor analyzes the output selection 
code associated with a test output data 
record to determine whether or not it is to 
process that particular record. This 
determination is based upon the output 
selection code or codes specified in the 
job control language execute (EXEC) state- 
ment for the editor job step. The output 
selection code indicated there is compared 
with the output selection code in the 
record itself; those records whose output 
selection codes are acceptable are proc- 
essed, and those whose output selection 
codes have not been specified are skipped. 
The actual output selection code for the 


job step is an integer from one to eight, a 


blank, or the letter A. The output selec- 
tion code in the record itself is either a 
value (see Table 1(C)) or a hexadecimal 
zero. 


The TESTRAN editor is always a separate 


job or job step. It is not automatically 
executed, but must be called for in the 
Same manner aS any other processor. 
RELATIONSHIP BETWEEN TESTRAN AND THE 
OPERATING SYSTEM 

The three parts of TESTRAN as_ they 
Operate within the operating system are 


shown in Figure 1. Parameters and options 
within job control statements are coded by 
the user to initiate the use of TESTRAN in 
a specific job. Control statements ini- 
tiate the assembly of the source state- 
ments, problem program and TESTRAN inter- 
preter execution, and operation of the 
TESTRAN editor. 


Jok control 
for assembly 


language statements calling 
require the reading of the 
TESTRAN source statements and an expansion 
of them. The expansion is directed by the 
macro-definitions in the macro-library. 
The expanded macro-instructions are assem- 





bled into the (TIA) table in the form of a 
control section separate from the problem 
program. The _TIA—table and the problem 
program text are written onto an output 
data set as object modules. 


The symbol table and external symbol 
dictionary from an assembly with a test 
parameter are written out with the object 
modules in an 80-character record format: 
labeled SYM. 
and test open routines together locate 
copy the data onto SYSTEST. 
editor uses the data to symbolically label! 
dumps and to identify section definitions; 
in its storage map. At this point, the, 
user either exits and suspends further 
operations, or supplies job control state-| 
ments to call for the execution of the) 
problem program. 





Before the object modules can be execut- 
ed, they must be linkage edited into a 
Single load module and fetched into main 
Storage. At appropriate times during the 
execution of the problem program, the 
TESTRAN interpreter honors the test 
requests that have been coded into the TIA 
table. Because the interpreter operates 
wholly in supervisor state, and the problem 
program operates entirely in problem state, 
operation alternates between the two states 
on a schedule determined by the TESTRAN 
statements that are being interpreted. 


Test output data generated by the inter- 
preter routines is written onto SYSTEST for 
later retrieval and editing by the TESTRAN 
editor. The functions of the interpreter 
are completed when the 
being tested reaches an end-of-task. 


When job 
calling for the TESTRAN editor are supplied 
by the user, the editor is fetched for 
execution. This may be directly foklowing 
the execution of the problem program or at 
some iater time. The. editor reads the 
interpreter's test output data from SYSTEST 
and determines from the output selection 
code whether a record is to be processed or 
skipped. If the record is to be processed, 
the editor provides proper headings, 
applies symbolic labels (when the symbol 
table is provided), converts data to prin- 
table format, and writes the record onto 
SYSPRINT. 
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Parts of TESTRAN Within Operating System/360 
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TESTRAN macro-instructions are a 
part of the macro-library of the IBM Oper- 
ating System/360 assembler processor. 
There are five basic macro-instructions in 
TESTRAN: TEST, SET, GO, DUMP, and TRACE. 
By including the first operand, these five 
basic macro-instructions are extended into 
23 usable macro-instructions. An installa- 
tion that uses TESTRAN enters the macro- 
definitions for these macro-instructions 
into the assembler macro-library at SYSGEN 
time. 


The 


The TEST, SET, and GO macro-instructions 





are classed as “test control" macro- 
instructions because their expansions 
provide internal control of TESTRAN. They 


oss 


a | 


do not generate output aS a primary pur- 
pose. The function of the DUMP and TRACE 
macro-instruction expansions is the genera- 
tion of test output. data. These two macro- 
instructions are classed as “test action" 
macro-instructions. a e 


macro~instructions normally 
expand into a sequence of executable 
instructions. TESTRAN macro-instructions, 
however, are translated and assembled into 
a series of constants called the TIA table. 


System 


These entries in the TIA table are test 
requests to be honored by the TESTRAN 
interpreter. 

Because the assembler does not expand 


any other TESTRAN macro-instruction until 
after a TEST OPEN macro-instruction is 
expanded, TEST OPEN must always’ be the 


first macro-instruction in an assembly. 


THE TIA TABLE 


te For each type of TESTRAN macro- 
instruction, there is a specific format 
that includes some mandatory and some 
optional fields. The formats are shown in 
Figure 2. For a detailed presentation on 
how to code these macro-instructions, refer 


stants. 


| ( to the publication IBM System/360 Operating 


System: Control Program Services. Each 
entry in the table has a type-entry field,” 








an identification field, and a length 
field. The three fields are referred to 
collectively as the “common data." The 
other fields of an entry are referred to 
collectively as the "variable fieid." 


Within the variable field there are various 
address (A) fields and modifier fields. 
Specific formats for each TESTRAN macro- 
instruction type are found in Appendix A. 


ASSEMBLING THE TIA TABLE 


Part I: . 


PART I: THE TESTRAN MACRO-INSTRUCTIONS 


Except for the TEST OPEN entry whose 
first two bytes form the operation code for 
an SVC instruction, the TIA table is 
composed of nonexecutable code. The TEST 
OPEN entry permits control to be passed to 


the TIA table and an interruption generated 


to allow testing to be initiated. 


TESTRAN macro-instruction statements may 
be coded and assembled with the problem 
program assembler-language source state- 
ments, or they may be coded as a Separate} 
assembly. The TESTRAN macro-instructions 
are always assembled into a separate con- 
trol section (CSECT). Depending on how the 
user wants to separate his test sequences, 
the TESTRAN macro-instructions may be 
assembled into more than one CSECT. Howev- 
er, a TEST OPEN macro-instruction must _be 











written for each CSECT desired. It is the 
CSECT, which has been formed for a_ series 
of TESTRAN macro-instructions, that is 


referred to as the TIA table. 


Assembling the TIA table in a separate 
CSECT from the problem program permits the, 
linkage editor to delete the TESTRAN CSECT 
(TIA table) from a load module when testing 
has been completed without the necessity of 
reassembling the problem program. If addi- | 
tional or different tests are desired, they 
can be coded into the TIA CSECT without 
altering the problem program being tested. 
Eliminating the need for reassembly of the 
problem program eliminates the possibility 
of new errors being introduced in the 
assembly process. 


When the assembler processor encounters 
a mMacro-instruction statement, it expands 
the statement into assembler language 
Statements as directed by the corresponding 
macro-definition. The assembler language 
statements generated during the expansion 
of TESTRAN macro-instructions are DC 
(define constant) statements. 


After the assembler 
appropriate DC statements for a given 
TESTRAN macro-instruction, it translates . 
them into the machine language constants 
that form the TIA table entry for the 
macro-instruction. The particular con- 
Stants generated for a given TESTRAN macro- 
instruction are determined by its 
corresponding macro-definition and by the 
Specific operands coded for the macro- 
instruction statement. 


has generated the 
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<-------—--——-------Variable Field--—--—-—-~--~--—-—--—~---—~+-+ > 

<-Common Data--> <---A Field----> <-~---—-Modif iers—-—-—---> 
| | ; | | | | | | | | [| | 
| T | ID { IN | | OR | L | AL | | P |] S J] FO [{ LO[[ F | 
| | | | | | | | | { | [| I | || | 
bee ee  SEaeENG SEM! COREE, as ee 


Legend 


T specifies type _ byte. The i1-byte hexadecimal code indicates the 
Macro-instruction type this entry represents. (See Table 1 (A).) 


ID represents identification byte. This 1-byte number is assigned to this 
mMacro-instruction at assembly time. (SVC number is assigned if type is 
TEST OPEN.) 


LN indicates entry length byte. This 1-byte number specifies the total 
length (in bytes) of this TIA entry. 





: 
| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

: 

| Note: Multiple A fields are possible. 

| | . | | 
| OR specifies organization byte. This 1-byte code indicates the 
{ organization for this A field. (See Table 1 (B).) 

| 

| L denotes length byte. This 1-byte number indicates the length (in 
| bytes) of the AL field if it is a literal. 

{ 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
L 


AL indicates address/literal. This is a variable length field whose 
contents depends on the organization byte. 


P specifies output selection code. This i1-byte code represents’ the 
1-to-8 priority (output selection code) scheme used by the TESTRAN 
editor. (See Table 1 (C).) 


S represents scale. This 2-byte count specifies the number of places 
(binary or decimal) point is to be shifted left. 


FO indicates format. This i1-byte data format identifier code specifies 
the format of the data to be referred to by this’ entry. (See 
Table 1 (D).) | 


LO specifies length overrider. This 2-byte value overrides the otherwise 
specified length of the data fields referred to by this entry. 


F represents flag byte. This 1-byte value indicates the presence of the 
P, S, FO, and LO modifiers in the variable field. 


Figure 2. General Format for TIA Table Entries 
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Table 1. Explanation of General Format Symbols for TIA Table Entries 
ee OT pe es Ay ee Me ae ee 
1 A. Type Byte Code | B. Organization Byte Code | 
}------------------ ~------------------------ {-------------------+----------------------- 4 
| Hex Code Entry Type | Bit O: "L" Field Flag | 
| 02 TEST AT | 1 - Present | 
| 06 DUMP DATA | 0 - Absent | 
| OA TEST OPEN | | 
| OE. DUMP CHANGES | | 
| 12 DUMP MAP | Bit 1: Not Used | 
| 16 DUMP PANEL | : | 
| 1A DUMP COMMENT | | 
l 1F DUMP TABLE | | 
| 22 TRACE REFER | | 
| 26 TRACE CALL | Bits 2 and 3: AL Field Type | 
| 2A TRACE FLOW | | 
| 2E TRACE STOP | 00 - Literal l 
| 32 TEST CLOSE | O01 - 24-bit absolute address | 
| 36 GO IN | 10 - 16-bit displacement address | 
| 3A GO OUT | 11 - 1-byte register number | 
| 3E GO BACK | (contents used as a value, | 
l 42 TEST DEFINE COUNTER | not an address) | 
| 46 TEST DEFINE FLAG | | 
4A SET COUNTER | | | 
| WE SET FLAG | Bits 4 through 7: Index Register | 
| 52 SET VARIABLE | | | 
| 56 TEST ON | 00 - No indexing | 
| 5A TEST WHEN | 01 through 15 - General register | 
| SE GO TO | | to be used to index address | 
| 62 END TABLE MARKER | in AL field | 
| -----~--------~----------------------------}----------—--------------------------------4 
| C. Output Selection Code | D. Format Code | 
}—---—~——--—-—-—-------—------ ee Se a + a ae ene Bi 4 
| 80 Output Selection 1 | O04 Fixed-point half | 
| 40 Output Selection 2 | 08 Fixed-point full | 
| 20 Output Selection 3 | OC Floating-point long | 
| 10 Output Selection 4 | 10 Floating-point short | 
| 08 Output Selection 5 | 14 Packed decimal | 
| 04 Output Selection 6 | 18 Unpacked decimal | 
| 02 Output Selection 7 | 1c Character | 
| 01 Output Selection 8 | 20 Address | 
| | 24 Hexadecimal | 
| | 28 Instruction | 
| | 2C Binary | 
cs a a ee ee a ed 
TESTRAN MACRO-DEFINITIONS check the macro-instruction Statement's 
| operand fields for critical errors. (A 
critical error is one that makes further 


is a macro-definition for each of 
the five basic TESTRAN macro-instruction 
types. Macro-definitions are placed in the 
macro-library at SYSGEN time. Brief des- 
criptions of the five macro-definitions 
follow. 


There 


TEST MACRO-DEFINITION 


When the assembler 
macro-instruction, it refers to the TEST 
macro-definition for directions. The TEST 
macro-definition directs the assembler to 


encounters a TEST 


Part I: 


processing of the macro-instruction impos- 
Sible.) If a critical error is detected, 
an error message is written, and expansion 
of the macro-instruction is terminated. If 
no critical errors are detected, the common 
data fields are generated, and positional 
operands are processed sequentially from 
left to right. Following the processing of 
positional operands, any keyword operands 
present are processed, the necessary flags 
are generated, and expansion of the macro- 
instruction is completed. 


The flow of the TEST macro-definition 
process is shown in Chart 10. 
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SET MACRO-DEFINITION 


When the assembler encounters a SET 
macro-instruction it refers to the SET 
macro-definition for directions. The SET 


macro-definition directs the assembler to 
perform the necessary diagnostic functions. 
If a critical error is detected, an error 
message is written and expansion of the 
macro-instruction is terminated. 
Otherwise, the common data is generated and 
positional operands are processed sequen- 
tially from left to right. If any keyword 
operands are present they are processed 
last. 


The flow of the SET macro-definition is 
shown in Chart 11. | | 


GO MACRO-DEFINITION 


When the’ assembler encounters a GO 
mMacro-instruction, it refers to the GO 
macro-definition for directions. The GO 
macro~definition directs the assembler to 
check for critical errors in the operand 
fields. If a critical error is detected, 
an error message is written and expansion 
of the macro-instruction is terminated. If 
not, the common data is generated, then the 
necessary addresses and flags are generated 
to complete the expansion. 


The flow of the GO macro-definition is 
shown in Chart 12. 


14. 


DUMP MACRO-DEFINITION 


When the assembler encounters -a DUMP 
Macro-instruction, it refers to the DUMP 
macro-definition for directions. The DUMP 
Macro-definition directs the assembler to 
check for critical errors in the operand 
fields. If a critical error is detected, 
an error message is written and expansion 
of the macro-instruction is terminated. If 
none are detected, the common data is 
generated, and the positional operands are 
processed sequentially from left to right. 
Following this, keyword operands present 
are processed, and any necessary flags are 
generated to complete the expansion. 


The flow of the DUMP macro-instruction 
is shown in Charts 13 and 14. 


TRACE MACRO-DEFINITION 


When the assembler encounters a TRACE 
macro-instruction, it refers to the TRACE 
macro-definition for directions. The TRACE 
macro-definition directs the assembler to 
check for critical errors. If any are 
detected, an error message is written and 
expansion of the macro-instruction is ter- 
Minated. Otherwise, the common data is 
generated and the positional operands are 
processed. Following this, the keyword 
operands present are processed and flags 
are generated to complete the expansion. 


The flow of the TRACE macro-definition 
is shown in Chart 15. 


4 
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| PART II: THE TESTRAN INTERPRETER 


The TESTRAN interpreter consists of the through the execution of TESTRAN SVC 
25 setup and service routines that are used instructions and through the execution of 
to test the problem program. With the the system macro-instructions LINK and 
ex@gption of the save routine, all of the XCTL. Exit from the routines is viaa 
routines function in the supervisor state RETURN or an XCTL macro-instruction. 
at problem program execution time. : 


The 16 service routines are executed in Except for the tracer routine, which 
response to a given macro-instruction and, normally is entered via an XCTL macro- 
Since macro~instructions can be coded in a instruction from the go back routine, all 
variety of sequences, the service routines service routines are entered from the rout- 


Freee CL i Dae ee saasiadiaa?” enceniemmead 


can also be executed in the same variety of er (setup) routine via “a” DINK macro- 


, seein eR TREAT: RI le ie petanminntet Aten te me 
a a 
Sl eumambmetiaraamenaenahaaanuant ee ge mn ae 


sequences. instruction. Table 2 is a complete list of 
| sae. the interpreter modules, their classifica- 
The 9 set up routines are executed at tions, and their normal residences. 

specific points in the execution of the | 

problem program. They support the service The TESTRAN interpreter generates test 
routines by acquiring storage for tables output data and writes it into SYSTEST. 
and by establishing the flags and switches This test..output data consists of two 
needed by the service routines. Entry into physical records for each logical” record 
the Various setup routines is gained The physical records in¢lude a prologue 


Table 2. MTESTRAN Interpreter Modules 


A aa ARB SR) 1a a li 
| Module ] Module | Service | | 
| Designation | Residence | or Setup | Macro-Instruction Interpreted | | 
|~---------—-- wf fn nn nn nner nerd 
{| IEGTTRNA§ | L | S | DUMP DATA,DUMP CHANGES | 
| LIEGTTRNB | L | S | DUMP COMMENT | 
} IEGTTRNC | L | S |} DUMP PANEL | 
| IEGTTRND | iF | S | GO TO,GO IN,GO OUT | 
| IEGTTRNE | L | S | TEST ON | | 
| IEGTTRNF | ie | S | DUMP TABLE | 
| IEGTTRNG | L | S | TEST WHEN | 
| IEGTTRNH | L | S | TEST CLOSE | 
| IEGTTRNI | L | Ss | GO BACK | 
|  IEGTTRNK § | # l S | DUMP MAP \ 
| LTEGTTRNL | L | S | TRACE FLOW,TRACE CALL, TRACE REFER | 
| IEGTTRNM§ | L | S {| TRACE STOP | 
| IEGTTRNN | L | S | SET COUNTER | 
| IEGTTRNO | L | O } mone (this is overlay 1 routine) | 
| LIEGTTRNP | i | S | SET FLAG } | 
{| IEGTTRNR | L | S | SET VARIABLE | 
| IEGTIRNT | L | S | TRACE FLOW,TRACE CALL, TRACE REFER | 
| IEGTTRNX | L | O | none (this is overlay 2 routine) | 
] IEGTTRNZ | L | O | none (this is trace interrupt routine) | 
| TIEGOPEN2 | L | (O&S) | none (this is phase 2 of TEST OPEN) | 
| IEGOPEN3 | ity (O&S) | none (this is phase 3 of TEST OPEN) 
Pabst ate | L | O | none (this is router routine) | 
| “ LEC038 | R | om | none (this is resident SVC routine) | 
‘| Iecoour l I l (06S) | TEST OPEN (this is phase 1 of 3) 
1 | IGCO106A | I ; O ] none (this is the save routine) | 
a ee ee i nb 
| Legend | 
| L - Module resides or Link library | 
| R - Module is part of resident nucleus j 
} I - Module resides on SVC library | | 
| S.- Module is service, interprets named macro-instruction | 
j} OO - Module is setup, supports service modules 28 . | 
| (TEST OPEN routines are a combination of both types) | 
a a a a a ge ed 
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record, which has a fixed length of 128 
bytes, and a data record, which has a 
variable length. The information concern- 
ing which macro-instruction caused the out- 


put to be generated is contained in the 

- prologue record. 
Although the test control macro- 
instruction entries (i.e., TEST, SET, and 


GO) do not generate output records as their 
primary function, the TESTRAN interpreter 


posts the execution of these macro- 
instruction entries in a buffer. When a 
test action macro-instruction entry (i.e, 
DUMP or TRACE) generates an output record, 


this buffer is written onto the prologue 
portion of that test action recerd and the 
buffer is cleared. Because of the size. of 
the prologue record, a maximum of 28 test 
control macro-instruction entry executions 
can be recorded on it. The data record of 
the record pair is of variable length, 
dependent on the record type. 


THe SETUP ROUTINES 


The setup routines perform the “house- 
keeping" and selection a enc necessary 
to support and control the choice of the 
service routines. These routines are 
executed at specific times, relative to the 
execution of the problem program. Their 
sequence of execution iS restricted, cer- 
tain routines being prerequisite to others. 


The save routine must be the first setup 


routine executed. If, is executed when the 
test attribute of the load module is’ reco- 
gnized by contents supervisor. Should the 
execution of a test open routine be 
attempted prior to that of the save rou- 
tine, the test open routine will not be 
executed. Instead, control will be given 
to the problem program and the problem 
program will be executed without being 
tested. | | : | 


If the save routine is executed prior to 
the time the test open routine is given 
control, however, the test open routine 
inserts SVC instructions into the problem 
program. These SVCs generate interruptions 
in the problem program and pass control to 
the TESTRAN interpreter. | 


In an overlay program, the overlay 
supervisor calls the TESTRAN overlay rou- 
tine whenever it fetches a new segment into 
main storage. Once the test open routine 
in executed in the root segment, this 
overlay routine performs test open func- 
tions on the newly loaded segment. 


16 


the control program nucleus. 


lan XCTL from the TSO TEST 


; routine 


! after the 





The resident SVC routine is a portion of 
When an 
interruption is caused by one of the svc 
instructions inserted by the TEST OPEN 
routine, this routine passes control to the 
router routine. 


The router routine can be executed only 
after the save and test open routines have 
been executed, control has passed to the 
problem progran, and an inserted SVC 
instruction has been executed. The trace 
interrupt routine is given control when an 
interruption occurs during a trace. 


THE SAVE ROUTINE (IGC0106A) 


The TESTRAN save routine (see Chart 30) 
retains the address and the extent data 
used by program fetch when load modules are 
acquired from their external residence. 
The test open routine later uses this data 
to acquire the symbol table and ESD records 
from the external residence. 


Entry to the TESTRAN save routine is via 
save routine 


(IGCOO06A) (see TSO Test/TMP PLM). If the 


| TESTRAN flag (test attribute bit) is set in 
jf the partitioned data 


set directory entry 
for the program load module member, the 
contents supervisor issues an SVC instruc- 
tion. This instruction resuits in a load 
of the TSO TEST save routine. The TSO TEST 
save routine will XCTL to the TESTRAN' save 
if the TCB under which the SVC was 
issued does not indicate a TSO task. 


The TESTRAN save routine iS executed 


load module containing the pro- 

, blem program and the TIA table is fetched, 
) but before it is given control. 

This routine acquires areas of main 


storage for the DCB/REL core and _ control 
core tables. It enters data into the 
DCB/REL core that relates to the external 
residence (disk) addresses of the symbol 
table and the external symbol dictionary 
(ESD) from the assembler, and the composite 
external symbol dictionary (CESD) from lin- 
kage editor. (The dictionaries and the 
table are generated at assembly time.) It 
also fills in a loaded address field in 
DCB/REL core for each CSECT in the load 
module and copies of the data control block 
(DCB) and the data extent block (DEB) that . 
were used by program fetch in loading the 





module. Addresses in the DCB and the DEB 
are corrected to show the actual loaded 
address. (For a detailed description of 


DCB/REL core, see Appendix B.) 


As one of its fields, control core 
contains a pointer to the DCB/REL core. It 
also contains fields for the pointers that 
are used by the TESTRAN interpreter to 
refer to its control blocks, and fields for 
the — various flags, buffers, temporary 


with the basic sequential 
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Storage areas, counters, and control blocks 
that are necessary for effective interface 
access method 
(BSAM) routines. [or 
trol core table is entered into the task 
control block (TCB) for the task. 7 


OTS TE apes “Oa AE HB LT IE 
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16.2 





Only a few of the fields in control core 
are filled at save time from the data 
supplied by the save routine. Data from 
the problem program or the TIA table is 
used to complete other fields during execu- 
tion of the test open and router routines. 


THE TEST OPEN ROUTINES 


The test open routines are the test 
routines that perform setup functions for 
the TESTRAN interpreter. The other test 
routines are discussed under "The Service 
Routines." 


Three routines are used to perform the 
TEST OPEN functions: TTOPEN 1, TTOPEN 2, 
and TTOPEN 3. These routines can be 
entered in two ways: one in which control 


is initially passed to the TEST OPEN entry 


in the TIA table at execution time, and the 
second in which a direct branch to the TEST 
OPEN entry is contained within the problem 
program. When control is passed to the 
TEST OPEN entry, the SVC 49 that is the 
first two bytes of the entry is executed. 
The interruption processed as a result of 
the SVC passes control to the TTOPEN 1 
routine. | 


In the first method of entry, the user 
supplies a linkage editor control ENTRY 
statement to the linkage editor at linkage 
edit time. This statement, when properly 
coded to do so, overrides the END statement 
in the user's assembler source module and 
causes control to be initially passed to 
the instruction named as the operand in the 
ENTRY statement. For example, if the user 
codes END START in his source module, at 
execution time control normally passes to 
the instruction named START to begin execu- 
tion of the program. 


When a linkage editor control ENTRY 
Statement such as ENTRY TEST is’ used, 
however, control passes to the instruction 


named TEST. Should TEST be the name of the 
TIA table associated with the problem pro- 
gram (and the name of its TEST OPEN entry) 
control passes to the TEST OPEN entry while 
the problem program still has its original 
END START statement (now overriden) for use 
after testing is deleted. 


To allow the test open routines to pass 
control to the beginning of the problem 
program so that it may be executed, the 
user must also code within his TEST OPEN 
macro-instruction an "entry" positional 
Operand that specifies the normal program 
entry point (i.e., START). In this entry 
method, deletion of the TESTRAN CSECT from 
the load module is accomplished by a _ pass 
through the linkage editor. Altering or 


- when this method of 


are called 
_instructions," and as such do 


output selection code, 


reassembling the problem program after 
testing is completed is not necessary. 


In the second method of entry, the user 
supplies a direct branch from within the 
problem program to the TEST OPEN entry in 
the TIA table. Reassembly of the problem 
program at the completion of testing in 
order to delete the branch is necessary 
entry is employed. 
Except for the reassembly requirement, this 
method has the same operation and require-~ 
ments as the first method. 


If the problem program to be tested is 
an overlay program and has multiple TIA 
tables, the test open routine ignores list- 
ed TIA tables which are not in main stor- 
age. 


with segments other than. ‘the | root _ segment 
"Secondary TEST OPEN __Macro- 
not require 
the inclusion of "entry" positional 
operands in their macro-instruction state- 


ments. 








Secondary TEST OPEN macro-instruction 
entries contained in the TIA tables asso- 
Ciated with overlay segments should never 
be given control and, therefore, never 
executed. Instead, the overlay 1 routine 
performs the necessary test open functions, 
such as inserting SVC instructions into the 
newly loaded segment. In an overlay pro- 
gram, the test open routines execute only 
once per execution of the program. 


The TTOPEN 1 Routine (IGC0004T) 


The TTOPEN 1 routine (see Chart 31) is 
entered initially as a result of the execu- 
tion of the TEST OPEN entry in the TIA 
table (the first two bytes of which are the 
operation. code for an SVC instruction). 
This routine determines if the save routine 
has been executed. If the save routine has 
not been executed, the test open functions 
are not performed, and control is returned 
to the problem program. The problem  pro- 
gram then executes as though there were no 
TESTRAN macro-instructions coded to test it 
(i.e., no testing takes place). 


If the save routine has been executed, 
the TTOPEN 1 routine loads the router 
routine into main storage and proceeds to 
examine the TEST OPEN entry in the TIA 
table to establish the maximums to be used 
for this execution of the problem program 
(i.e., number of lines of test output data 
aklowed and number of TESTRAN statement 
executions allowed). This information, the 
and the link or load 
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option specified in the TEST OPEN entry are 
placed into the proper fields of control 
core. (For a detailed description of con- 
trol core, see Appendix B). 


At this point in its execution, the 
TTOPEN 1 routine links to the TTOPEN 2 
routine if it determines that this is its 


first execution Since the execution of the 
save routine. Otherwise, the TTOPEN 1 
routine links to the TTOPEN 3 routine to 


prepare the problem program for testing. 


After the TTOPEN 3 routine has operated, 
inserting SVC instructions into the problem 
program and establishing various TESTRAN 
tables, it returns control to the TTOPEN 1 
routine. The TTOPEN 1 routine writes a map 
change record (if necessary), the TIA and 


reference tables, and a test open record 
onto the intermediate data set (SYSTEST) 
for use by the TESTRAN editor. The map 


change record is generated fc for each program 


= ne neers rename cat te 


overlay | and it. - indicates the ‘presence _ and 


teen ak ae, ame, ae 


active or inactive status of ‘each program 


segment in main “storage. 


load mode option is 
Specified in the TEST OPEN macro- 
instruction. In the load mode, routines 
are acquired from the link library via the 
LOAD macro-instruction and then control is 
passed to them via ae LINK macro- 
instruction. Routines, up to the available 
limits, are retained in storage. In the 
link mode, routines are acquired from the 
‘link library when they are needed. No 
attempt is made to retain them in storage. 


iNote: The link or 


The TTOPEN 2 Routine (IEGOPEN2) 


The TTOPEN 2 routine (see Chart 32) 
performs the copying functions of test 
open. With this routine, control core 
fields are initialized and the data whose 
address and extent has been recorded and 
retained in DCB/REL core by the Save 
routine is copied for later use by the 


TESTRAN editor. 


The TTOPEN 2 routine uses DCB/REL core 
address data to read records (symbol table, 
ESD, and CESD) from their external resi- 
dence into an area of storage it acquired 
for a buffer. It copies them from the 
buffer onto SYSTEST. Buffers acquired by 
the routine and storage acquired for use as 
DCB/REL core are then released. Control 
returns to the TTOPEN 1 routine. 
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includes the reference, counter, — 


Note: 


The TTOPEN 3 Routine (IEGOPEN3) 


The TTOPEN 3 routine (see Chart 32) 
prepares the problem program for testing. 
It first determines if the TIA table it 
refers to is already open, and if so, 
returns control to the TTOPEN 1 routine. 
If the TIA table is not open, this routine 
tests for valid entry types in the TIA 
table. 


If all the entries are valid, the rou- 
tine computes the amount of storage it will 
need for a block called table core by 
scanning the entire TIA table to determine 
the number of flags and counters (either 
explicitly or implicitly defined) and the 
number of TEST AT entries in the table. 
(For a description of table core, which 
and flag 
ta see Appendix B.) The routine then 
acquires the necessary main storage. The 
routine scans the TIA table a second time 
and inserts SVC instructions into the prob- 
‘lem program at each point specified in. a 
TEST AT entry in the table. It also 
inserts, into the reference table area that 
corresponds to that TEST AT entry, the two 
bytes of problem program code that the SVC 
instruction displaced, and the locations of 
the SVC instruction in the problem program 
and the TEST AT entry in the TIA table. 


tablés, 


Likewise, the TTOPEN 3 routine enters a 
flag into the flag table area for each flag 
specified in a TEST DEFINE FLAG TIA entry. 
The counter table area of table core is 
filled in, in this same manner, with the 
counters specified in the TEST DEFINE COUN- 
TER TIA table entries. Pointers to the 
first entry in each of the reference, flag, 
and counter tables are entered into the 
fixed area of table core (or the previous 
reference, flag, and counter tables). AD 
pointer to table core is entered into 
control core (or the previous control 
core). 


To ensure that the TIA table associated 


with a problem program is not altered by 
that program, the TESTRAN interpreter cofe- 
putes a "checksum" of the TIA table and 


stores it in table core. 


The checksum is a Summation of the 
entire TIA table, added in 4-byte incre- 
ments. The add logical instruction is used 
to compute the 4-byte sum. When the length 
of a TIA table is not an even multiple of 
four bytes, the remaining bytes are right 
justified and added to the low order end of 
the previous sum. 


Whenever the TESTRAN router routine _ is. 
entered ~ during _ “execution of the problem 


program, a checksum of ali SIA tables in 


a ee, 


main storage as they exist at that time is 
computed. If newly computed checksum 
does not Gatch the one stored in table 
core, that TIA table has been altered anda 
message to indicate this iS written onto 
SYSTEST. As a result the task is brought 


to an abnormal end (ABEND). 


If additional TIA tables are listed in 
an “OPTEST=" operand field in the TEST OPEN 
entry, the next TIA table is examined to 
determine whether or not it is currently in 
storage. If it is, that TIA table is aiso 
opened (i.e., the TTOPEN 3 routine is 
repeated for the next TIA table). If there 
are no more TIA tables to be opened, 
control is returned to the TTOPEN 1 rou- 
tine. 


THE RESIDENT SVC ROUTINE (IGC038) 


The resident SVC routine (see Chart 30) '° 


consists of the parameters and instructions 
for linking to the router routine. Whena 
TESTRAN-inserted SVC instruction is execut- 
ed during problem program 
execution/testing, the operating system's 
SVC handler passes control to the resident 
SVC routine. This routine, in turn, passes 


control to the router routine that was 
loaded by the TTOPEN 1 routine. When a 
series of TIA table entry interpretations 


are complete, control is returned from the 
router routine, “through ‘the -resident_ _SVC 


routine, to the problem ‘program. — 


THE ROUTER ROUTINE (IEGTTROT) 


The router routine (see Chart 33) deter- 
mines from the entries in the TIA table 
which of the TESTRAN interpreter service 
routines are to be executed. Each time it 
is entered, this routine tests the validity 
of each TIA table currently in main storage 
by computing a checksum of the table and by 
comparing that checksum with the original 
one computed and stored in table core by 
the TTOPEN 3 or overlay 1 routine. If the 
checksums do not agree, the router routine 
issues an error message to indicate that 
the TIA table has been altered and brings 
the task to an abnormal end (ABEND). 


Some of the service routines of the 
interpreter are classified as "test 
control" routines because they are not 


concerned with the generation of test out- 
put data, but rather with the internal 
control of testing. As one of these rou- 
tines is executed, the router routine 
enters information to indicate that it has 
been executed into a prologue record buf- 
fer. This information, in the form of a 
list of executed Statements, iS written in 
the prologue record of the output record 
pair generated for the next “test action" 


routine executed. 


To pass control to the proper service 
routine, the router routine first deter- 
mines the address of the SVC instruction 
that caused it to receive control by sub- 
tracting two bytes (length of the Svc) from 
the address of the next problem program 
instruction as it appears in the old _ pro- 
gram status word (PSW). This gives the 
routine the address of the SVC instruction 
in the problem program. The router routine 
then scans the reference table to find a 
Matching address in the object program 
address field. When it finds this matching 
address, the address in the TIA address 
field (within the same entry in the ref- 
erence table) is the address of the TEST AT 
Macro-instruction entry that caused the SVC 
to be inserted. The router routine then 
scans the TIA table to find the type byte 
of the next entry. 


The router routine uses the type byte as 
an index factor to find the correct charac- 
ter in an internal table. The character is 


appended to the symbolic name root 
(IEGTTRN) of the Service routines to com-_ 
plete the symbolic name of the required 
service routine. The router routine then 


links, or loads and links, to the routine. 
Control returns to the router routine when 
the service routine has completed its func- 
tions. If the previous routine was not a 
go back routine, the router routine exam- 
ines the next entry and repeats the above 
procedure. If it was a go back , control 
is returned to the problem program or to 
the tracer routine, as explained in the go 
back discussion. 


Two of the router's subroutines are 


contained entirely within it and are 
branched to as required. The first, 
HBADDRSR (see Chart 34), interprets "A" 
field expansions (see Appendix A) in the 


TIA entries, computes an actual address for 
these entries, and returns that address to 
the service routine that needs it. The 
second, HOQOUTPUT (see Chart 34) controls 
the writing of prologue and data records of 
an output record pair. It also checks’ the 
output-line count to ensure that the number 
of lines generated has not exceeded the 
maximum allowed. 
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THE OVERLAY ROUTINES 


The Overlay 1 Routine (IEGTTRNO) 


In an overlay program, whenever the 


overlay supervisor causes a new segment 
with test attributes to be fetched into 
main storage it links to the overlay 1 


routine (see Chart 35). 


The overlay 1 routine first determines 
whether or not the test open routine has 
operated, and if it has not, this routine 
causeS a map change record to be written 
onto SYSTEST and returns control to the 
overlay supervisor. 


If the test open routine has been exe- 
cuted, the overlay 1 routine next checks 
the count of TIA tables listed for the 


OPTEST= operand of the TEST OPEN entry in 
the root segment TIA table. If the OPTEST 
count is zero, and if the trace mode switch 
is on, control is passed to the overlay 2 
routine. For OPTEST count zero and trace 
mode switch off, a map change 
written onto SYSTEST and control is 
returned to the overlay supervisor. 


When the OPTEST count is non-zero, the 
overlay 1 routine determines which TIA 
table is next in the list and if that table 
has ever been opened. If the TIA table has 
previously been opened, this routine checks 
to find whether it is now in main storage. 
If the TIA table is not in main storage, 
its associated reference, flag, and counter 
tables are flagged inactive, and the OPTEST 
count is again tested for zero or nonzero. 


If the next TIA table has been opened 
previously, and iS now in main storage, the 
TESTRAN SVCsS are inserted into the freshly 
loaded copy of the segment. The OPTEST 
count iS again tested for zero or non-zero. 

When the next TIA table in the OPTEST 
list has not been opened previously, a 
check is made to determine if it is now in 
Main storage. If it is not, it is ignored 
and the OPTEST count is again tested for 
zero or non-zero. If, however, the TIA 
table is now in main storage the overlay i 
routine performs the normal test open func- 
tion on the TIA table and then returns to 
check the OPTEST count for zero or non-zero 
again. 


The Overlay 2 Routine (IEGTTRNX) 


The overlay 2 routine (see Chart 36) is 
used whenever there are active traces’ in 
progress at the time an overlay occurs. 
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of trace 


record is’ 


The overlay 2 routine checks each table 
core to find the numbers of any inactive 
TIA tables. The trace table is 
for entries with matching TIA table num- 
bers. Any such matching traces are stopped 
by removing their entries from the trace 
table. A trace stop record is written onto 
SYSTEST. If all active traces are stopped 
as the result of an overlay, the overlay 
stop bit is set in the trace stop flag byte 
‘core. Exit from this routine is 
to the overlay supervisor via a RETURN 
macro-instruction. (Trace core is 
explained in detail in Appendix B.) 


THE TRACE ROUTINES 


Tracing operations within TESTRAN 
require the use of both setup and service 
routines. The trace interrupt routine is a 
setup routine, the other trace routines are 
service types and are discussed in the 


section entitled "The Service Routines." 


The TRACE INTERRUPT Routine (IEGTTRNZ) 


If it becomes necessary either to sus- 
pend or halt tracing during a trace opera- 
tion, the trace interrupt routine (see 
Chart 38) is used. Depending on the event 
that triggered it, the routine initiates an 
abnormal-end-of-task (ABEND) sequence of 
events, transfers control to the tracer 
routine (via an XCTL macro-instruction), or 
returns control to the problem program (via 
the router routine). The following condi- 
tions cause the trace interrupt routine to 
be given control: | 


e Program check, which causes a transfer 
of control to the tracer routine if a 
user~Supplied interrupt routine exists 
(SPIE macro-instruction). If no user- 
Supplied interrupt routine exists, an 
ABEND results. 


e Trace stop Switch set on (stop flag 
byte in trace core), which writes an 
output message to indicate that tracing 
hasbeen stopped and returns control to 


the problem program, providing the 
Switch has been set by an overlay 
routine. 

e Untraceable SVC (LINK, XCTL, or 


RETURN), which generates an output 
record and returns control to the prob- 
lem program via the router routine. 


searched 
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Procedure for Decimal Instructions on 
Model 91 


Trace interrupt routine modifications 
for handling decimal instructions encoun- 
tered when operating on the Model 91 are 
described in this part under the _ section 


“Modifications of Trace Interrupt and Go 


Back Rouen for the Model 91." 


THE SERVICE ROUTINES 


The service routines perform the test 
services specified by the TESTRAN macro- 
instructions. There are 16 service rou- 
tines to accommodate the 23 TESTRAN macro- 


instructions: three TEST, three SET, two 
GO, five DUMP, and three TRACE. With the 
exception of the tracer routine, each of 


these routines is entered via a LINK macro- 
instruction issued by the router routine. 
The tracer routine is entered via an xXCTL 
macro-instruction from the go back routine. 


THE TEST ROUTINES 


7 Except for the test. open routine, which 
is a setup routine, the routines. that 
correspond to the other TEST macro- 
' instructions are service routines. 

routines include: test on, test when, and 
test close. , 3 7 


The TEST ON Routine (IEGTTRNE) 


The test on routine (see Chart 36) 
examines the value in the counter in the 
TIA entry to determine if the value is a 
multiple of the stipulated interval within 
the high and low limit specification. If 
the counter value meets the requirements, 
control returns to the router routine with 
the address in the VF pointer altered to 
show the address of the entry named as’' the 
operand of the TEST ON entry. If the 
requirements are not met, testing continues 
in an unaltered sequence. 


Note: TESTRAN uses a register, called the 
varible field (VF) pointer, as a next entry 
indicator. The ' VF pointer is incremented 
as the router routine examines the TIA 
table entries. It points to the first byte 
of the next entry when the test services 
requested by the current entry have been 
executed. To transfer from the interpreta- 
tion of one series of TIA table test 
request entries to another, the address of 
the first entry in the new series is 
substituted for the address of the next 
sequential entry in the VF pointer. 


The pointer is required for normal 
sequential flow from one TIA entry to the 
next as well as when the normal flow is 
altered. Conditional entries such as TEST 


ON and TEST WHEN, and unconditional entries 


These 


- and one 


such as GO IN, GO OUT, and GO TO use the VF 
pointer to alter the sequence of 
interpretation. | 


The TEST WHEN Routine (IEGTTRNG) | 


(see Chart 37) 
Specified in the 


The test when routine 
compares two operands 
entry. Depending on the result of the 
comparison, the routine either continues 
interpreting TIA entries or starts inter- 
preting a new sequence beginning with the 
one specified in the test when entry. The 
user may specify one of six different 


“operators™ upon which to base his compari- 
son. These operators include: 

Equal to 

‘Less than 


Less than or equal to 
Not equal to 

Greater than | 
Greater than or equal to 


A comparison has a “true" result whenev- 
er the result conforms to the operator that 
was chosen. For example, if operand 1 has 
a lesser value than operand 2, and the 
operator chosen by the user is “less than", 
the result of the comparison is true. If, 
however, the same two operands were com- 
pared using “equal to” as the operator, the > 
result of the comparison would be “false”. 


The two operands may be either flags or 
values in any one of several optional data 
modes (fixed point, floating point, hexade-— 
cimal, character, etc.). The test when 
routine has. four comparison subroutines: 
one for fixed point values; one for float- 
ing point values; one for decimal values; 
that compares any of the 
hexadecimal-, character-, binary-, 
instruction-, or address-coded values. 


The test when routine makes the compari- 
son specified in its entry and, if the 
result is true, causes the address of the 
entry specified as the operand of the TEST 
WHEN entry to replace the address of the 
next sequential entry in the VF pointer. 
Thus, interpretation of the sequence of TIA 
table entries in which the TEST WHEN was 
located is terminated, and the interpreta—_ 
tion of a new series is begun. A false 
result of the comparison causes a continua-— 
tion of the interpretation of the current 
series of test requests. 


The TEST CLOSE Routine (IEGTTRNH) 


The test close routine (see Chart 39) 
closes the TIA table or tables that were 
opened by the test open routine when test- 
ing of the problem program was initiated. 
When the router routine encounters a TEST 
CLOSE entry in the TIA table, it links to 
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the test close routine which, in turn, 
reinserts the problem program instruction 
bytes that were displaced by the inserted 
Svc instructions. The routine retrieves 
the bytes from the reference table portion 
of table core and relinquishes the storage 
acquired for any table core associated with 
a closed TIA table. : 


Any trace operations started by entries 
in the closed TIA table are halted and a 
trace stop record is written onto SYSTEST. 
A test close record is also written onto 
SYSTEST. A-bit is set on in the stop flags 
byte of trace core if all traces. are 
stopped. 


A device called the dummy go _ back, 
unique to the test close routine, is used 
to return control to the problem program. 
For entries other than a TEST CLOSE, a GO 
BACK entry (either explicit or implicit) 
eventually follows in the TIA table. In 
such cases, control returns to the problem 
program via the go back routine, the router 

routine, and the resident SVC routine. 


After the test close routine is execut- 
ed, the TIA tanle is no longer active, and 
no interpretation of an entry following the 


TEST CLOSE entry can be made. The VF 
pointer, therefore, iS set to the address 
of a GO BACK entry in control core. This 


control core entry is labelled DUM and isa 
dummy GO BACK entry. Using the dummy go 
back as a device to pass control to the go 
. back routine after the execution of a test 
close routine, control returns to the prob- 
lem program, from the go back routine, in 
the normal manner. 


THE GO ROUTINES 


Although there are four GO macro- 
instructions, the TESTRAN interpreter uses 
only two routines to interpret them. The 
GO IN, GO OUT, and GO TO macro-instructions 
are interpreted by one routine; the GO BACK 
macro-instruction by the other. Routines 
for the GO macro-instruction entries 
unconditionally alter the sequence of TIA 
table entry interpretation when the router 
routine encounters their entries. The test 
On and test when routines alter the 
sequence of TIA table entry interpretation 
conditionally and are essentially addition- 
al go routines. 


The GO IN/GO OUT/GO TO Routine (IEGTTRND) 


Whenever the router routine encounters a 
GO IN, GO OUT, or GO TO entry in the TIA 
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control 


. next 


entered, and zeros that 


table, it passes control to the go. routine 
{see Chart 40). The actual execution of 
the go routine, however, is different for 
each entry. os 


For a GO TO entry, the address, speci- 
fied as the location of the TIA table entry 
to be interpreted next, is checked to 
determine if it is an entry in an active 
and open TIA table. If it is, the address 
is placed into the VF pointer register and 
is returned to the router routine. 


For a GO IN entry, the address 
sequential entry that was in the VF 
pointer register is stored in the subrou- 
tine table for retrieval at the time a GO 

OUT macro-instruction entry is interpreted. 
(The subroutine table is a 9-byte table 
within control core. It can hold up to 
three such addresses.) 


For a GO OUT entry, the address of the 
next entry to be interpreted is retrieved 
from the subroutine table and entered into 
the VF pointer register. (The address of 
the next entry for GO TO and GO IN entries 
is contained within the entry itself.) 


Note: The subroutine table consists of 
three 3-byte entries. At each entry to the 
router routine (the execution of an SVC 
instruction inserted for a TEST AT entry in 


‘the TIA table), the subroutine table is 
zeroed. The go in routine fills the first 
vacant entry with the address of the next 


sequential TIA table entry following the GO 


IN itself. This address is used by the go 
out routine so that it can return to the 
next entry in the former sequence of 
entries. | 


Likewise, any Subsequent GO IN entries 
enter the address of the otherwise next 
sequential entry into the subroutine table. 
If there are more than three entries into 
the table, the first entry is "lost". When 
a go out routine retrieves an address from 
the subroutine table, it takes the last one 
entry. Sequences 
of TIA table entries can be "nested" to a 
depth of three, the depth of the subroutine 
table. | 


The GO BACK Routine (IEGTTRNJ) 


The go back routine (see Chart 41) is 
entered via a LINK macro-instruction from 
the router routine. This routine is 
entered whenever the router routine encoun- 
ters an explicit or implicit GO BACK entry 
in the TIA table. A GO BACK entry is. 
implied if the router encounters either an 
end-of-table marker entry, or a TEST AT 


entry Signifying the beginning of a new 


of the _ 
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In either case, 
interpreted 


series of test requests. 
the series of entries pexnd 
have come to an end. 


With an explicit GO BACK aitiy: the user 
can specify the address (problem program 
address) to which he wishes control to be 
returned. The problem, program is’ then 
reentered at a point other than the one 
from which the inserted SVC instruction 
caused it to be interrupted. If no address 
is specified in an explicit entry, the 
removed problem program instruction is 
reassembled and executed remotely. Control 
is then returned to the instruction follow- 
ing the inserted SVC via the router and 
resident SVC routines. The go back routine 
alters the address stored in the old PSW to 
make these returns possible. 


If the trace mode switch has been set, 
the go back routine passes control to _ the 
TRACER routine instead of returning control 
to the problem program. If the user has 
supplied an SPIE macro-instruction to 
handle a program interruption, and that 
interruption occurs, the go back routine 
passes control to the user-supplied inter- 
ruption handler routine. Otherwise, if a 
program interruption occurs, the go back 
routine initiates an ABEND. 


Procedure for Decimal instructions on 
Model 91 


Go back routine modifications for handl- 
ing decimal instructions encountered when 
operating on the Model 91 are described in 
this part under the section “Modifications 


of Trace interrupt and Go Back Routines for | 


the Model 91." 


| THE SET ROUTINES 


Each SET macro-instruction has its own 
service routine. The SET routines receive 
control from the router routine via a LINK 
macro-instruction. When their function is 
completed, control returns to the router 
routine. 


The SET FLAG Routine (IEGTTRNP) 


The first operand in the TIA table entry 
for the SET FLAG being interpreted is 
checked to ensure that it is in the _ flag 
table of an open and active TIA table. The 
second operand may also be a flag. If so, 
it is also checked to determine whether or 
not it is in an active flag table. If the 
first operand is an active flag and the 
second operand is either an active flag or 
a specific value, the first operand is set 
to the value of the second. If the second 
operand is a valid storage address, the 


it (trace.table) must be acquired 


set to the value of the 
(See Chart 


first operand is 
contents of the second operand. 
42.) | 


The SET COUNTER Routine (TEGTTRNN) 


The fivse operand in the TIA table entry 
for the SET COUNTER being interpreted is 
checked to ensure that it is in the counter 
table of an active and open TIA table. 
Likewise, the second operand, if it is a 
counter, is checked to determine whether or 
not it is in an active counter table. If 
the first operand is an active counter and 


the second operand is either an active 
counter or a specific value, the first 
operand is set to the value of the second. 


If the second operand is a valid storage 
address, the first operand is set to the 
value -of the contents of the | second. 
operand. (See Chart 42.) 


The SET VARIBLE Routine (ILEGTTRNR) 


The first operand in the TIA table entry 
for the SET VARIBLE being interpreted is 
checked to ensure that it is within the 
user's task; i.e., either a register ora 
field in main storage. The second operand 
is checked to ensure that it is either a 
valid storage address, an active counter, 
or a literal. If the checks indicate that 
both operands are valid, the first operand 
is set to equal the register, literal, or 
counter value of the second operand. If 


the second operand is a valid storage 
address, the first operand is set to the 
value of the contents of the second 


operand. (See Chart 39.) 


THE TRACE ROUTINES 


There are three trace routines to inter- 
pret the four TRACE macro-instructions. | 
Two routines, trace start and tracer, are 
executed for the TRACE CALL, TRACE FLOW, 
and TRACE REFER entries; the other, for the 
TRACE STOP entry. The trace service rou- 
tines are supported by the trace setup 
routine (trace ee 


Whenever the go back routine is sietea. 
it interrogates the trace mode switch (a 
flag bit in control core). The trace mode 
switch is set on by the trace start rou- 
tine, when the first trace is started, to 
indicate that any subsequent trace is not 
the first and that a table called “trace 
core" already exists. If the trace mode 
Switch is off, the storage required for 
trace core and the table contained within 
: and the 
initialized. The address of the 
(and trace core, since the 
is the first portion of trace 


tables i 
trace table 
trace table 
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core) is entered into a field of control 
core. A record-pair, containing a prologue 
record that includes a type byte to indi- 
cate what type of trace has been started, 
is written as output from the execution of 
the TRACE START routine. The additional 
data describing the trace, addresses for 
start and stop limits of the trace, is 
written into the data record. (Detailed 
descriptions of trace core and trace table 
are in Appendix B.) 


To perform a trace operation, TESTRAN 
routines copy a problem program instruction 
from its location in the program to a 
remote location (low end of main storage), 
examine it, then remotely 
that location. The exact procedure depends 
on the problem program instruction and the 
type of trace being made. 


The low order 48 bytes of main storage 
are used temporarily by the tracer routine, 
their original contents are saved and later 
restored. The contents of the general 
registers, aS they appeared in the problem 
program, 
tion is executed and then preserved 
it is executed. | 


after 


On each entry to the tracer routine, the 
stop flags byte in trace core is examined 
to ensure that no event has stopped all 
traces since the last entry. Except for 
program check interruptions that are en- 


abled by the problem program, all interrup- 


tions are disabled. Six bytes of problem 
program, beginning with the next instruc- 
tion to be executed, are moved to location 
zero in main storage. The 
then examined and the course of action to 
be taken is determined. 


Should the instruction type cause a 
branch in the problem program, it is first 
determined whether or not the branch should 
occur. If the branch would occur during a 
normal untraced operation it must be deter- 
mined whether or not a TRACE FLOW or TRACE 
CALL is in effect and whether or not this 
branch requires an output record to be 
generated. If a record is necessary, it is 
written onto SYSTEST to indicate the 
branch. The pointer used to indicate 
problem program instruction to be examined 
next is altered so that it now contains the 
"branch to” address. 


_ If the instruction examined is a_ store 
type anda TRACE REFER is in progress, the 
routine changes the storage protection key 
to that of the problem program and writes a 
“before"™ record of the area onto SYSTEST. 
It then executes the instruction and re- 
stores the storage protection key to zero. 
If the conditions required for a "“before" 

record to. be written were met, an “after" 
record must also be written. 
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it is moved (six bytes) 


execute it. at 


are restored before the instruc-_ 


instruction is. 


the | 


If the examined instruction is an exe- 
cute, it is first determined that the 
operand instruction is not also an execute, 
Since it is invalid to execute an execute.) 
If the operand instruction is a valid type 
| to location zero 
and the determination of its type is begun 


just as though it were an “in line" 
instruction. — The 
next-instruction-to-be-exanined-pointéer is 
kept pointing at the instruction that 


follows the execute. 


For certain traceable SVC instruction 
types encountered, a trace stop record is 
written and control is returned to the 
router routine. If the generation of a 


trace flow output record is required, it is 
written. 
With. privileged instructions, control 


passes to the trace interrupt routine via 
an XCTL macro-instruction. | 

For all instructions other than those 
mentioned above, the instruction iS moved 
to location zero, and executed. Interrup- 
tions are enabled, and the process’ starts 
again with the next problem program 


instruction. 


The TRACE START Routine (IEGTTRNL) 


The trace start routine (see Chart 37) 
initiates trace operations within TESTRAN 
by writing a trace start record. and ini-. 
tializing trace core and the trace table. 
For the starting of subsequent traces, it. 
adds an entry to the trace table for each 
new trace. | 


Note: Since the trace table is limited to 
ten entries, the number of concurrent trac- 
es is also limited to ten.. Should the 
number of traces exceed ten, the last trace 
started is "“lost". (The trace table is 
sorted by trace type and the last entry is 
flagged. An entry for a trace after the 
tenth one replaces the previous last 
entry.) | 7 


execution of the trace 
start routine, control returns to the rout- 
er routine. If the router determines that 
the next entry in the TIA table represents 
another test action or test control macro-. 
instruction to be acted upon, it proceeds 
to do so, ignoring the fact that the trace 
mode switch is on. 


Following the 


If, however, the next eee is a GO BACK 
(either explicit or implicit) and the go 
back routine finds that the trace mode 
switch is set on, instead of returning 
control to the problem program, the go back 


routine passes control to the tracer 
routine so that it may monitor each problem 
program instruction. (Even if the entries 
directly after the TRACE entries are other 
than GO BACK entries, this condition will 
eventually occur. ) 


The TRACER Routine (IEGTTRNT) 


The tracer routine does not interpret 
TIA table entries directly, but rather, 
with the trace start routine provides the 
tracing services. (See Chart 43.) 


When the router routine passes control 
to the go back routine at the completion of 
a sequence of test requests, the go 


routine tests the status of the trace mode 
Switch. If the trace mode switch is set, 
the go back routine passes control to the 


tracer routine, which examines each problem 
program instruction and executes it remote- 


ly. 


If a TRACE CALL is being executed, each 
CALL macro-instruction executed within the 
area Specified by the TRACE CALL entry in 
the TIA table causes an output record pair 
to be generated and written onto SYSTEST. 


If a TRACE FLOW is being executed, each 
branch to or from the areas specified in 
the TRACE FLOW entry in the TIA table 
causes an output record pair to be generat- 
ed and written onto SYSTEST. 


If a TRACE REFER is being executed, each 
instruction that alters the contents of any 
area specified in the TRACE REFER entry in 
the TIA table causes an output record pair 
to be written onto SYSTEST. 


Should the tracer routine encounter a 
TESTRAN SVC instruction while it is execut- 
ing the problem program, control returns to 
the router routine. 


Whenever a privileged instruction is 
encountered, whenever a program check 
occurs, or whenever an untraceable SVC 


(LINK, XCTL, or RETURN) is encountered in 
the problem program, control passes from 
the tracer routine to the trace interrupt 
routine. | 


A machine check interruption that occurs 
while the tracer 
results in an ABEND. 


Note: While the tracer routine is execut- 
ing the problem program, interruptions are 
enabled and then disabled after each prob- 
lem program instruction is executed. SVC 
called routines such as the overlay 
visor are not traced. | 


back 


routine iS in operation | 


super- 


The TRACE STOP Routine (IEGTTRNM) 


The trace stop routine (see Chart 37) is 
entered when the router routine encounters 
a TRACE STOP entry in the TIA table. If 
the entry has no specific traces named as 
operands, all traces are stopped and their 
entries are removed from the trace table. 
If, however, specific traces are named as 


operands, each trace so named is stopped 
and its entry is removed from the trace 
table. A bit in the stop flags byte of 


trace core is set. on if all traces are 
stopped by a TRACE STOP entry interpreta- 


Each entry in the trace table 


contains 
data to identify its type, its output- 
record priority codes, its TIA table and 


Macro-instruction numbers 
to this trace, and the 
limits of the trace. © 


that correspond 
Start and stop 


THE DUMP ROUTINES 


Five dump routines are used to interpret 
the six DUMP macro-instructions. The DUMP 
DATA and DUMP CHANGES macro-instructions 
are interpreted by one routine; the other 
four by their respective dump routines. 


All of the routines are entered from the 
router routine via a LINK macro- 
instruction. . 


The DUMP DATA Routine (IEGTTRNA) 


Whenever the router routine encounters a 
DUMP DATA or DUMP CHANGES entry in the TIA 
table, it links to the dump data routine 
(see Chart 40). The dump data routine 
determines whether these addresses are 
Within the physical size limitations of the 
computing system, whether the start address 
is lower than the stop address, and whether 
the area requested is more than 65,535 
bytes long. If no violations are discov- 
ered, the contents of the area specified is 
written onto SYSTEST. 


Except for a unique type byte in the 
prologue, the same output is generated for 
both a DUMP DATA entry and a DUMP CHANGES 
entry if both are concerned with the same 
area of storage. | 
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The DUMP COMMENT Routine (IEGTTRNB) 





Whenever the router routine ineteprets a 
DUMP COMMENT entry in the TIA table, it 
links to the dump comment routine (see 
Chart 40). This routine generates a prolo- 
gue record that contains a DUMP COMMENT 
type byte and the identification numbers of 
both the TIA table being interpreted and 
the macro-instruction whose TIA entry 
caused this entry to the dump comment 
routine. The record-pair is written onto 
SYSTEST, with the data record of the pair 
consisting of a dummy record. The actual 
comment itself is not written onto the data 
set. (The TESTRAN retrieves the comment 
from the TIA table at edit or edit time.) 


The DUMP MAP Routine (IEGTTRNK) 


The router routine links to the dump map 
routine (see Chart 40) whenever it encoun- 


ters a DUMP MAP entry in the TIA table. 
. The dump map routine generates an output 
record-pair that consists of a prologue 


record and a data record. The data record 
contains a series of subrecords acquired 
from system tables, one for each field of 
storage associated with the current task. 
The number of subrecords is indicated in 
the data record. 
information as to whether that area iS a 
program or a data area, the name of the 
program to which the area is assigned, and 
the beginning address and length of the 
area. After the record-pair is written 
onto SYSTEST, control returns to the router 
routine. 


The DUMP PANEL Routine (IEGTTRNC) 


Whenever the router routine encounters a 
DUMP PANEL entry in the TIA table, it links 
to the dump panel routine (see Chart 40). 
This routine retrieves the contents (at the 
time of the inserted-SVC-caused interrup- 
tion) of the 16 general registers from the 
register save area. It also gets the 
contents of the floating-point registers 
(if present) directly from the registers, 
and the contents of the old PSW. An 
indentifying prologue record and a data 
record that contains the data items just 
described are written onto SYSTEST. When 


the TESTRAN editor processes the record at 
edit time, it selects the required 
registers. 


The DUMP TABLE Routine (IEGTTRNF) 


The dump table routine (see Chart 31) is 
linked to by the router routine whenever it 
encounters a DUMP TABLE entry in the TIA 
table. The DUMP TABLE entry specifies 
either the TCB, DCB, or DEB. If a TCB is 
specified, the task control block of the 
requesting task is written out as the data 
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Each subrecord contains 


record portion of a record-pair. If a DCB 
is specified, the named data control block 
is written out as the data record portion 
of the record-pair. If a DEB is specified, 


the named DCB is examined and the address 


of the data extent block is obtained from 
the field in the DCB. The contents of the 
DEB are written as the data record. When 
the function of this routine is completed, 
control returns to the router routine. 


MODIFICATIONS OF TRACE INTERRUPT AND GO 
BACK ROUTINES FOR THE MODEL 91 


In the simulaticn of problem program 
instructions while operating in either the 
trace mode or the go-back mode of TESTRAN, 
a program interruption occurs on the Model 
91 whenever the TESTRAN interpreter encoun-: 
ters a decimal instruction of the problem 
program. The TESTRAN Trace and Go-back 
routines have been modified tc permit the 
TESTRAN interpreter to utilize the facili- 
ties of the Decimal Simulator (IFAXDSO0) 
routine via the PFLIH routine. 


When either the TESTRAN Trace Interrupt 
routine (IEGTTRNZ) or the TESTRAN Go-back 
routine (IEGTTRNJ) receives a program check 
interruption caused by an invalid operation 
code, a ‘routine-to-TESTRAN' PSW and an 
error return address are established in the 
TESTRAN Control Core. (The TESTRAN Control 
Core contains the PSW at location 448 and 
the error return address at location 444.) 
The high-order bit (called the ‘return-to- 
TESTRAN' flag) in the TESTRAN Control Core 
Pointer (i.e., the TCBTRN field) in the TCB 
is set to 1 to indicate that the TESTRAN 
program is entering the PFLIH routine. 
-TESTRAN saves the contents of the general. 
registers 9 through 8 beginning at location 
456 jin the control core. Control is then 
given to the PFLIH routine. 


If the decimai instruction that TESTRAN 
gives to the PFLIH routine, and which 
subsequently is given to the Decimal Simu- 
lator, is Sinulated successfully, the 
Decimal Simulator routine returns’ control 
to TESTRAN. Return is achieved by locating 
the ‘return-to-TESTRAN" PSW and then using 
the LPSW instruction. 


If the decimal instruction is not simu- 
lated successfully, the Decimal Simulator 
routine returns control to the PFLIH rou- 
tine, which checks the ‘return-to-TESTRAN' 
flag to ensure that the entrance to the 
PFLIH routine was from TESTRAN. The 
address of the TESTRAN error-handling rou- 
tine is moved into the ‘return-to-TESTRAN' 
PSW, and control is given to the error 
routine. The TESTRAN interpreter |recog- 
nizes the type of error that was detected 
ty the Decimal Simulator routine by testing 





The functions of the 
routine are 


the program old PSW. 
TESTRAN error-—handling 
unchanged. 


INTERPRETER LOGIC FLOW EXAMPLE 


Figure 3 shows the flow of control 
through a simplified problem program/TIA 
table execution. The problem program/TIA 
load. module includes CSECTs for both the 
problem program and the TIA table. 


The load module uses SVC instructions 
and RETURN macro-instructions to communic-— 
ate with the TESTRAN interpreter's test 
open routine and router routine (setup 
routines). The router routine communicates 
with the TESTRAN interpreter‘s dump, go 
back, tracer, and trace stop routines (ser- 
vice routines) via LINK and RETURN macro- 
instructions. An XCTL macro-instruction is 
used for communication between the go back 
and tracer routines. | 
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After program fetch enters the load 
module into main storage and the contents 
supervisor determines that the load module 
has test attributes, control passes to the 
TSO TEST save rcutine via an SVC 61 
instruction. The TSO TEST Save routine 
will XCTL to the TESTRAN interpreter's save 
routine if the TCE under which the Svc 61 
instruction was issued does not indicate a 
TSO task. , 


The save routine retains the address 
data used by program fetch when it acquired 
the load module from its external residence 
and then returns control to the contents 
supervisor. The contents supervisor, in 
turn, passes control to the entry point 
specified for the load module; i.e., the 
TEST OPEN entry in the TIA table. 


This entry, executable as an SVC 49, 
causes an interruption and transition from 
problem to supervisor states. The test 
open routine obtains storage for its tables 
and initializes them. It inserts an SVC 38 
instruction into the problem program at 
each point specified ina TEST AT entry in 
the TIA table. 
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TESTRAN 


TEST OPEN 

TEST AT Z 

DUMP DATA E-F 
GO BACK 

TEST AT Y 

TRACE FLOW G-H 
GO BACK 

TEXT AT X 

TRACE STOP 

62 (End Table) 
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Figure 3. TESTRAN Interpreter Logic Flow Example 


The test open routine copies onto the 
output data set the assembly time symbol 


tables, and external symbol dictionary 
(ESD) data acquired from their external 
residence using the address data retained 


routine. It also writes a 
composite ESD (CESD) record, a relocation 
table record, and records consisting of 
copies of the TIA and reference tables. In 
addition, it writes a test open record for 
the editor, indicating that test open has 
occurred. It then Loads the TESTRAN inter- 
preter's router routine into main storage 
and passes control to the 
at the point specified 
Macro-instruction; i1.ée., 
labeled START. 


by the save 


in the TEST OPEN 
the instruction 


Control is in the problem state and 
remains in this state and within the _ pro- 
blem program until an inserted SVC 38 
instruction is encountered. Control then 


goes to the supervisor state and through 
the resident SVC routine to the router 
routine, which determines the SVC 38 


instruction that caused this . interruption. 


problem program. 


the entry and passes control, 
problem program 


This routine also determines which TESTRAN 
test request is coded into the TIA table 
immediately after the TEST AT entry that 
caused that SVC to be inserted into the 


\ 


In Figure 3, location Z in the problem 


program CSECT is specified as the point at 


which the tests are to begin. The next 
entry in the TIA table specifies DUMP DATA 
E through F. The router routine examines 
via a LINK 
macro-instruction, to the DUMP DATA rou- 
tine, which operates in the supervisor 
state. After the contents of the main 
storage area between instructions E and F 
are . written onto the SYSTEST, control 
returns to the router routine. 


The router routine determines. that the 
next TIA. entry is a GO BACK entry and 
passes control to the go back routine viaa 
LINK macro-instruction. The go back rou- 
tine executes the problem program instruc- 
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tion displaced when the SVC 38 was inserted 
into the problem program. It then returns 
control to the problem program at instruc- 
tion E. Control is again in the problem 
state. It remains in this state through 
anstruction F. | 7 


When instruction Y is executed, another 
Svc 38 causes an interruption and a transi- 
tion from problem to supervisor state 
occurs. As a result of the interruption, 
the router routine receives control. It 
then locates the TIA table entry that 
follows the proper corresponding TEST AT 
entry; 1-e., TEST AT Y. 


Since the next TIA entry is a TRACE FLOW 
G through H, the router routine passes 
control to the trace start routine to 
initiate the trace. This routine estab- 
lishes the tables and entries necessary for 
trace operations. It also generates an 
output record to indicate that the trace 
has been initiated and sets a switch to 
show that a trace is in progress. When 
this operation is completed, control 
returns to the router routine. The router 
routine examines the next sequential entry 
in the TIA table to determine the next 
routine to get control; i1.e., a GO BACK 
entry. Control, therefore, passes to the 
go back routine, which reassembles’ the 
_displaced problem program instruction and 
then examines the switch that indicates 
whether or not a trace is in progress. (It 


examines this switch each time it receives 
control.) Since there is a trace in = pro- 
gress and the switch is set, the go back 


control to the 
rather passes it to 


routine does not return 
problem program, but 
the tracer routine. 

- within 


The tracer routine operates 


supervisor state but executes the problem 


oe 


proper 


BACK). 


program. It examines the problem program 
instruction-by-instruction and executes it 
remotely. | | 


Each instruction is "lifted" from the 
problem program sequentially, beginning 
with the one displaced by the Svc, and 


examined to determine whether it is a 
program-transfer type instruction or an 
execute that causes a program-transfer type 
to be executed. If it is such an instruc- 
tion within the specified limits of the 
trace, an output record is generated to 
describe the action. 


In Figure 3, control remains with the 
tracer routine until the routine encounters 
the SVC 38 at location X. As the result of 
encountering the SVC, the router routine 
receives control and it again finds the 
entry in the TIA table to be inter- 
preted; i.e., the TRACE STOP entry. AS a 


result of the execution of the trace stop 
routine, all traces in progress are 
stopped. In this case, since the TRACE 


FLOW is the only trace in operation it is 
the only trace that is stopped. The trace 
stop routine removes the trace table entry 
that identifies the trace. An output mes- 
sage, which indicates that the trace was 
stopped, is written and control returns to 
the router routine. 


The router routine again determines the 
next entry in the TIA table; i.e., an 
end-table entry, (which is an implied GO 
The router routine passes control 
to the go back routine. The go back 
routine reassembles the displaced problem . 
program instruction and executes it. Con-_ 
trol then passes via the resident SVC 
routine to the problem program, which con- 
tinues to execute without further TESTRAN . 
steps. | 





The TESTRAN editor is a post processor 
that functions after the execution of the 
problem program. Operating completely 
within problem state, it converts test 
output data generated by the TESTRAN inter- 
preter into a printable output which the 
user can employ to debug his problem pro- 
gram. The editor is a separate job or job 
step and is scheduled and controlled in the 
Same way aS any problem program or proc- 
eSsor. 


Thirty-eight routines make up the 
TESTRAN editor. These routines are divided 
into the following: 


° Initialization routines. 
e Internal routines. 
e Output routines. 


All the TESTRAN editor's routines reside 
on the link library (SYS1.LINKLIB) parti- 
tioned data set. Control is passed among 
the routines via LINK, xXCTL, and RETURN 
macro-instructions and to the routines of 
the root module via direct branches. 


The overall program structure of the 
TESTRAN editor is shown in Figure 4. The 
editor's routines are used ina variety of 
patterns which are determined by the 
sequence of records read from the input 
data set. The input data set processed by 
the editor is the TESTRAN interpreter's 
output data set (SYSTEST). | | 


In addition to test output data generat- 
ed by the TESTRAN interpreter's service and 
setup routines, the interpreter's test open 
routine writes records that contain copies 
of the TIA and reference tables, the assem- 
bler symbol table (SYM), and external sym- 
bol dictionary (ESD), the composite exter- 


nal symbol dictionary (CESD), and the con- 
trol section relocation table. If the 
problem program is an overlay program, the 


test output data also includes map change 
records. These records, when available, 
are used by the TESTRAN editor to prepare 
Symbolically labeled output records for the 
user. Although the editor can function 
Without most of these input data records, 
it cannot function without a copy of the 
TESTRAN interpreter‘s TIA table. 


Job Step 
Initiation 
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Figure 4. TESTRAN Editor Organization 


OPERATION OF THE TESTRAN EDITOR 





The TESTRAN 
scheduled job 
after the execution of a 
which has been under test with TESTRAN. 
For the editor to operate, a TIA table for 
testing the problem program must have been 
assembled and linkage edited into a load 
module with the problem program, following 
which the program must have been executed. 
The interpreter setup and service routines 
must have generated some test output data 
and written it onto a secondary storage 
data set whose ddname is SYSTEST. This 
data set must be made available as input to 
the editor at its execution time. 


editor is a separately 
step that must be executed 
problem program 


The editor provides the user witha 
printed output to use in debugging the 
problem program. Storage dumps are iden- 
tified with loaded and assembled addresses, 
and symbolic labels are applied to data 
items they name. Dumps of program areas of 
Storage can be printed with the assembler 
language mnemonics inserted, floating point 
data items can be printed in decimal form, 
etc. 


The TESTRAN editor builds and uses sev- 
eral tables which are essential to its 
operation. The various tables serve to 


establish the environment of the problem 
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program as it existed when each test output 
data record was generated. 


EDITOR TABLES 


The editor alters and updates its tables 
throughout its execution. This continuing 
process of keeping the tables current, 
relative to the problem program's execu- 
tion, is the job of the internal routines. 
The tables include the table dictionary, 
the map, the action table, the dump. change 


table, the symbol table, and the reference 
table. Diagrams and field-by-field break- 
downs of these tables are contained in 


Appendix C. 


TABLE DICTIONARY 


dictionary contains four 

These entries give the 
Starting address and the current length of 
the map, the reference table, the action 
table list, and the dump change list. 


The table 
8-byte entries. 


MAP 

The editor's map contains a series of 
24-byte entries. Each entry is updated 
continuously, throughout execution of the 
editor, to show the identification, the 
Status, and the significant addresses of a 
defined section of the problem program. 
Defined sections include CSECTs, DSECTs, 


unnamed or private code CSECTs, and blank 
common control sections. The number of 
entries in the map depends on the number of 
program sections that are loaded. The 
Maximum size of the map is determined 
during initialization, and is one of the 
two possible sizes indicated in the 
listing. 


ACTION TABLE LIST 


The action table list contains a series 
of 10 byte entries. The entries give the 
secondary storage address and identifi- 
cation needed by the editor's routines to 
locate the action table and a specific 
entry within the action table. The number 
of entries in this table is dependent on 
the number of test open routine executions 
during the execution of the problem pro- 
gram. Maximum size for this table is 
indicated in the listing. 
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entry types, 


ACTION TABLE 


The action table is a version of the 
TESTRAN interpreter's TIA table which has 
been altered by an editor internal routine 


to eliminate data not needed and to fix the 


length of some variable fields. 
nal interpreter TIA table has 


The origi- 
up to 23 
whereas this altered version 
retains only 9 entry types. If it exceeds 


the size of the buffer used, the altered 
TIA table (action table) is written on 
secondary storage as it is altered. The. 


action table list permits the retrieval of 
the action table entries. A fixed length 
buffer in main storage is used to form the 
secondary storage records. This buffer is 
also used by the symbol table initializer 
routine. 


DUMP CHANGE LIST 


The dump change list is a series of 
5-byte entries used to point to the secon- 
dary storage residence of a dump change 
table. Each entry gives the TIA table 
number and the number of the DUMP CHANGES 
macro~instruction entry within that TIA 
table, plus the address on secondary stor- 
age of the dump change table. The number 
of entries in this table (list) depends on 
the number of DUMP CHANGES entries inter- 
preted at problem program execution time. 
The maximum size of the list is determined 
at initialization and is one of two possi- 
ble sizes as indicated in the listing. 


DUMP CHANGE TABLE 


The dump change table contains a_ series 
of 9-byte entries. This table is main- 
tained on secondary storage. It indicates 
the loaded address (at problem program 
execution time), the length, and the secon- 
dary storage location of the specified 
data. This data is the last copy of the 
area of storage referred to in a dump 
changes TIA entry. It is the copy of the 
storage area with which the editor compares 
the copy in a dump changes record it is 
processing. 


SYMBOL TABLE 


The editor‘*s symbol table is an altered 
version of the assembler's symbol table 
which was passed to the editor by the 
interpreter test open routine. The symbol 


table is stored on secondary storage in 
records of a fixed length (size of symbol 
table buffer) for each section definition. 
An entry is made in the editor's map to 
identify the first record of each symbol 
table. Each record of variable length 
symbol table entries is given a heading 
which indicates the last (highest) offset 
from the origin, into the defined section, 
of the current record. The heading also 


indicates whether that record is the last 
record of a table. This heading data 
speeds the search for symbol information 


needed by the editor routines. 


REFERENCE TABLE 


The TESTRAN editor's reference table 
contains a series of six byte entries. It 
is an altered version of the TESTRAN inter- 
preter reference table. It contains the 
displaced instruction bytes and their loca- 
tions in the problem program plus’ the 
segment number of the associated TIA table. 
It is used by the editor in showing what 
instruction was displaced, in dump type 
output records containing inserted SVCs. 


The number of entries in this table is 
dependent on the number of TEST AT entries 
in the interpreter TIA table. The maximum 
number of entries is determined at initial- 
ization and is one of two possible limits 
indicated in the listing. 


INITIALIZATION ROUTINES 
The Start Routine (IEGMCOOA) 
At edit time, 


control passes initially 


to the start routine. (See Chart 50.) 
This routine gets main storage for input 
record buffering. It tailors the table 
Sizes to the amount of storage available. 


The start routine processes parameters from 
the job control EXEC statement (PARM=). It 
also opens the three data sets used by the 
editor: the input data set (SYSTEST), the 
intermediate data set (SYSUT1), and the 
output data set (SYSPRINT). SYSTEST is the 
output data set from the interpreter, gen- 
erated at problem program execution time. 
SYSUT1 is the editor's scratch or working 
data set maintained on secondary storage. 
SYSPRINT is the data set upon which the 
editor's output print data is written. 


The start routine passes control to a 
LOAD macro-instruction routine to call the 
editor's root module (IEGMNOOA) into main 
Storage. The tables and buffers used by 


| by the start routine and 


count is 


printed is 


the editor are initialized by the start 
routine after it has acquired the necessary 
storage. The area of main storage occupied 
by the start routine is relinquished when 
it passes control to the root module via an 
XCTL macro-instruction. | 


The Root Module (IEGMNOOA) 


The root module is divided into a com- 
munications area, an I/O interface, and 
three discrete routines; the print routine, 
the line out routine, and the editor router 
routine. 

The module is loaded into main storage 
remains resident 
storage throughout the editor's 
execution. The root module is the only 
editor module that iS maintained thus. 
Control is passed to the module's’ routines 
from other editor routines via a branch 
list. 


in main 


Print Routine (IEGSHOOA): The print rou- 
tine writes the editor’s output records 
onto SYSPRINT. This routine is device 
independent. It may or may not actually 
print the output records. When control 
passes to the print routine, the current 
120-character buffer is written onto SYS- 
PRINT and the line count total is incre- 
mented. To write the record onto SYSPRINT, 
the print routine calls upon the I/O inter- 
face routine to establish communication 
between it and data management's BSAM which 
performs the writing function. 


When the maximum line count per page is 
reached, a page eject is initiated and a 
new header record written before the next 
output record can be written. Once an 
output record is written, its buffer is 
cleared. 


The print routine checks the output page 
count. If the established maximum page 
reached, a Special exit from the 
print routine is taken. 3 


Line Out Routine (IEGSBOOA): The line out 
routine builds the print lines written onto 
SYSPRINT by the print routine. Data to be 
indicated to this routine 
through designated general registers and 
parameters that are contained within the 
communications area. Information concern- 


ing the source of the data, the length of 
the data, and the number of blanks to 
follow the data are all passed to this 
routine. 

A pointer in the communications area, 
indicating the current position in the 
current buffer into which data can be 
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added, is used to indicate where the data 
fits into the buffer. The line out routine 
updates this same pointer and checks for 
attempted line overflows, passing control 
back to the calling routine through an 
overflow exit without entering anything in 


the line if such an overflow attempt 
occurs. 

Editor Router Routine (IEGMEOO0OA): The edi- 
tor router routine (see Chart 50) controls 


the reading of 21 input record types from 
SYSTEST and makes an initial analysis of 
the record type. Depending on that analy- 
Sis, this ‘routine links to the action 
router routine for records that require the 
selection of a routine to process them, or 
back to the routine that processed the 
previous record for a continuation type 
input record. 


I/O Interface (IEGMN80A): All reading and 
writing of input, output, and secondary 
storage data within the TESTRAN editor uses 
the I/0 interface portion of the root 
module. This portion contains the DCBs, 
the DECBs, and the buffering routines used 
by the editor in its interface with BSAM. 


Communications Area (IEGMNOOA): The com- 
munications area of the root module con- 
tains the constants needed by the editor's 
other routines to maintain contact with one 
another. It contains the constants.) and 
common address parameters used by the other 
routines and a branch list to allow control 
to be passed from a routine to one within 
the root module. 


The Editor Message Routine (IEGSFOOA) 


All error and informational-type mes- 
Sages issued by the editor are written 
under control of the editor message rou- 
tine. (See Chart 51.) The message text is 
stored within the calling routine. Whenev- 
er an editor routine requires a message to 
be written onto SYSPRINT, it links to this 
routine. The editor message routine, in 
turn, calls the line out routine to move 
the selected message to the current print 
buffer, and the print routine to write the 
message onto SYSPRINT. At the conclusion 
of its functions, the editor message rou- 
tine returns control to the editor routine 
that issued the message request. 


INTERNAL ROUTINES 


The TESTRAN editor's internal routines 
process the input record types that provide 
information concerning the problem program 
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filled it is written onto secondary 
All the action table entries are 


whose test output data is being edited. 
This information is maintained by the edi- 
tor in the form of storage maps and tables. 
Each time the problem program"’s storage 
configuration changes due to an overlay, 
the TESTRAN interpreter writes a map change 
record which is essentially a copy of the 
overlay segment table. 


Each map change record is applied to the 
Storage map by the internal routines to 
reflect the current (relative to problem 
program execution) status of storage. Any 
output records that follow can then be 
applied to the proper program section and 
any symbolic data available can be assigned 
to the proper data. Other internal rou- 
tines update tables used by the editor, 
generate editor altered versions of inter- 
preter tables, process symbol table 
records, and provide end-of-run processing 
when needed. | 


The Reference Table Routine (IEGRKOOA) 


The reference table routine (see Chart 
52) processes reference table type records 
read from SYSTEST. It refers to the prolo- 
gue record or the editor's map to determine 
the overlay segment number of the TIA table 
associated with this reference table, and 
adds this information to the data in the 
reference table entry from the interpreter. 
The address of the TEST AT macro- 
instruction entry in the interpreter's TIA 
table is deleted from the 
entry and the resulting altered form of the 
entry is stored in the editor's reference 
table. When it completes the processing of 


the reference table record, this routine 
returns control to the editor router 
routine. 


The Action Table Routine (IEGRLOOA) 


The action table routine (see Chart 52) 
is linked to by the action router routine 
when the router routine determines that the 
current input record is a TIA table type. 
The routine eliminates all TIA table entry 
types except for the test open, dump, and 
trace types. These entries are altered to 
eliminate non-useful data An editor action 
table is formed from them. As the fixed 
length buffer used to form the table is 
stor- 
age. 
presented in Appendix C. 


reference table. 


ye ON 








The Invalid Record Routine (IEGPEOOA) 


The invalid record routine (see Chart 
53) keeps an invalid record count that is 
updated each time an unreadable or invalid- 
type record is encountered as input to the 
TESTRAN editor. If the invalid record 
count reaches three, the input is 
considered to be uneditable and the editor 
run is terminated. Control passes to the 
editor message routine, so that a message, 
indicating that the count of 
records has exceeded the Jlimit, 
issued. 


can be 


If the count has not reached three, an 
invalid record message is issued and con- 
trol is returned to the editor router 
routine. Should the count reach the limit, 
after issuing both the invalid record and 
excessive invalid records messages, the 
invalid record routine passes control to 
the end-of-run routine to terminate the 
job. 


The End-of-Run Routine (IEGPKOOA) 


The end-of-run routine (see Chart 53) is 
entered via an XCTL macro-instruction from 
the invalid record routine. An actual 
end-of-data-set condition from 
exceeding the maximum~-pages~of-output 
limit, an uncorrectable I/O error, or an 
invalid CSECT relocation table record also 
causes control to be passed to this rou- 
tine. The routine writes (on SYSPRINT) an 
end-of-job message, a maximum pages message 
or an I/O error message (when applicable), 
and a count of statements processed. It 
also closes the data sets opened by the 
editor and returns control to the supervi- 
Sor. 


The Relocation Table Routine (IEGREOOA) 


The relocation table routine (see Chart 
52) processes CSECT relocation table 
records written by the TESTRAN interpreter. 
Since the editor‘s map is kept sorted on 
the loaded address field, the order of 
entries within the map.does not correspond 
to the sequence in which the entries were 
made. Each entry in the map, therefore, is 
given a sequence number. 


When a CSECT relocation table record is 
processed, the relocation table routine 
applies each relocation factor to the map 


in sequence number order (i.e., from the 
lowest numbered CSECT to the highest num- 
bered one). Following the application of 


invalid 


record to the TESTRAN 


SYSTEST, — 


the relocation factors, this routine 
searches the program storage area for 
defined sections which occupy storage iden- 


tified in the map as_ belonging to some 
other defined section. Such a situation 
develops when using LOAD, DELETE, LINK, and 


XCTL macro-instructions but not through an 
overlay. In such circumstances, the entry 
in the map that details the section that 
has been "stored over" is purged from the 
map. The routine again sorts the map on 
the loaded address field. It then returns 
control to the editor router routine. 


factor cannot be cor- 
a message is issued 
terminated. 


If the relocation 
related with the map, 
and the editor run is 


The Map Change Routine (IEGRCOOA) 


The map change routine (see Chart 54) 
processes the map change record from the 
interpreter and applies the data in the 


editor's map. The 
storage map contains information that con- 
cerns the storage in use by the problem 
program at the time testing was taking 
place. The map change record is written by 
the interpreter because an overlay of the 
problem program has altered the contents o 

storage. : 


CSECTS and their associated TIA tables, 
which were active and may have been gener- 


ating test output data previous’ to the 
overlay, may have been overlaid and no 
longer he active. For the editor to apply 
the proper set of symbolic labels to the 


test output data it is processing, it must 
keep its storage map current, relative to 
that data. The map change routine alters 
the map to keep it current, reflecting the 
changes from active to inactive (or vice 
versa) of all CSECTs so_ changed. At its 
completion, it returns control to the edi- 
tor router routine. 


The CESD Map Routine (IEGRAOOA) 


When the action router routine (see 
Chart 53) determines that the input record 
from SYSTEST is a CESD record, it passes 
control to the CESD map routine via an XCTL 
macro-instruction. If an editor 
exists, the addresses assigned by the link- 
age editor and contained in the CESD record 
are inserted in it, and sequence numbers 
are assigned to the CSECTs in the map. If 
no map exists when a CESD record is read, 
this routine creates one from the available 
information. At the conclusion of its 


operations, this routine returns control to 


the editor router routine. 
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map 


The Symbol Table Processing Routines 


Five routines are 
editor to process symbol table (SYM) 
records. The routines process both the 
assembler SYM records and the assembler's 
external symbol dictionary (ESD) records. 
The output from these routines is written 
onto secondary storage (SYSUT1). This sec- 
ondary storage data is in the form of an 
altered symbol table arranged to expedite 
retrieval by the other editor routines. 


Symbol Table Base Routine (IEGRFOOA): The 
Symbol table base routine (see Charts 55 


and 56) receives control, via an xXCTL 
macro-instruction, from the action router 
routine when it finds that the input record 
to be processed is a symbol table record. 
The routine establishes addressability of 
the communication area for the SYM rou- 
tines. It contains subroutines necessary 
to get the variable length SYM records from 
the input area and to build and search the 
editor map. 


This routine remains resident in main 
storage throughout the SYM processing with 
control being passed to its subroutines 
from each of the other SYM routines. 


Symbol Table Initializer Routine 
(IEGNSOOA): The symbol table initializer 


routine (see Charts 55 and 56) receives 
control from the symbol table base routine 
via a LINK macro-instruction. Initial 
entry to this routine causes the contents 
of the action table buffer to be saved by 
writing it onto secondary storage. This 
frees the buffer for use during the execu- 
tion of the symbol table initializer rou- 
tine. The routine causes the editor map 
base to be established. Subsequent entries 
to this routine are via an XCTL macro- 
instruction from the symbol table last pass 
routine at the conclusion of SYM processing 
for each assembly of the load module. If 
more data (SYM or ESD records) is to be 
processed the symbol table initializer 
routine operates and then passes’ control, 
via an XCTL macro-instruction, to the sym- 
bol table first pass routine. Otherwise, 
the action table buffer is restored, and 
control is returned to the editor router 
routine. 


Symbol Table First Pass Routine (IEGNYOOA): 
The symbol table first pass routine (see 


Charts 55 and 56) is entered from the 
symbol table initializer routine via an 
XCTL macro-instruction. It processes the 
variable. length input SYM records into 
fixed length recoids, sorts these records, 
and writes them onto SYSUT1. 


This routine exits, via an XCTL macro- 
instruction, to the symbol table ESD 
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used by the TESTRAN 


.records 


routine when the SYM records (in the input) 
end and are followed by the ESD records. 


Symbol Table Last Pass Routine (IEGSPOOA): 
The symbol table last pass routine (see 


Chart 57) is entered from the symbol table 
base routine at the conclusion of: process- 
ing SYM records from each assembly. It 
gets the fixed length records formed by the 
symbol table first pass routine from their 
secondary storage residence and processes 
them into variable length records broken 
down by CSECT. The new strings of symbol 
table records formed by the preceding proc- 
esS are again written onto Secondary stor- 
age (SYSUT1) and the I/O address 
symbol table data for each CSECT is placed 
in the editor map entry for that CSECT. 


The symbol table last pass routine 
exits, via an XCTL macro-instruction to the 
symbol table initializer routine to process 
any following SYM records. 


The Symbol Table ESD Routine (IEGRGOOA): 
The symbol table ESD routine (see Chart 58) 


processes the ESD records read in as part 
of the SYM records. If the record is a 
section definition (CSECT, DSECT, etc.), 


the symbolic name is inserted 
editor map. The routine is terminated by 
the symbol table base routine at the end of 
each assembly's SYM records so that the 
symbol table base routine can get the next 
input record if it is a SYM record. 


OUTPUT ROUTINES 


The output routines produce output 
from the data supplied by the 
TESTRAN interpreter. They are supported by 
the initialization and internal routines. 
The output routines prepare symbolically 
labeled output data in the form of storage 
dumps, and traces for the user to employ in 
debugging his problem programs. The ini- 
tial determination that a record read in by 
the editor is other than a continuation 
type is made by the editor router routine. 
When the editor router routine detects such 
a record, it passes control to the action 
router routine so that it may determine 
which routine is 
record. 


The Interpreter Message Routine (IEGPIOOA) 


The interpreter message routine 
Chart 53) receives control from the action 
router routine for either of the two inter- 
preter message record types. The records 
contain the code used by the interpreter 


of the. 


into the 


needed to process that. 


(see. 


Pa 


a 


message routine to select the proper mes- 
Sage from the table of messages contained 
within the routine itself. Depending on 
which of the record types the routine is 
processing, the executed statements line 
may or may not be printed. To identify the 
message aS a TESTRAN interpreter message, 
this routine prefixes the characters 
"“*** TEGI" to the head of the message. 


If the message includes an address aS a 
suffix, this routine links to the address 
analyzer routine to allow display of the 
address in symbolic form. It uses the line 
out and print routines of the root module. 


This routine exits, via a RETURN macro- 
instruction, to the editor router routine. 


The Action Router Routine (IEGMGOOA) 


If the editor router routine determines 
that the record from SYSTEST is to be 
processed, it passes control to the action 
router routine (see Chart 54). The action 
router routine further analyzes the record 
to determine whether it requires an output 
routine to process it, and if so whether 
its output selection code is one which is 
to be processed. If the record does not 
have one of the selected output selection 
codes, it is ignored. Control remains with 
the action router until any continuation 
records for the non-selected record have 
been read, following which control is 
returned to the editor router routine. 


When the routine processes an output 
record, it formats the “AT LOCATION" (where 
applicable), the "EXECUTED STATEMENTS", and 
the "CURRENT ACTION" lines. It locates the 
editor action table entry that corresponds 
to the record and then passes control to 
the specific output routine, which process- 
es that record type, via an XCTL macro- 
instruction. 


If the record to be processed is one 


which requires the use of an internal 
routine, this routine passes control to 
that internal routine via an XCTL macro- 
instruction. | 


The DUMP COMMENT Routine (IEGNMOOA) 


If the action router routine determines 
that the record to be processed is a DUMP 
COMMENT type, it passes control to the DUMP 
COMMENT routine (see Chart 59) via an xXCTL 
Macro-instruction. The DUMP 
routine extracts the comment number from 
the prologue record of the DUMP COMMENT 


COMMENT — 





record-pair and uses it to find the comment 


in the editor action table. The comment is 
moved to the current print buffer and then 
written onto SYSPRINT by the line out and 
print routines, respectively. At the con- 
pletion of this action, control is returned 
to the editor router routine. 


The DUMP TABLE Routine (IEGNPOOA) 


¢ 


When the action router routine deter- 
mines that a DUMP TABLE record is being 
processed, it passes control to the DUMP 
TABLE routine (see Chart 59) via an xXCTL 
macro-instruction. The DUMP TABLE routine 
examines the action table entry associated 
with this record to determine which table 
type is to be dumped and then applies 
available names to the respective logical 
sections of the block. Lengths and . names 
of fields, and the sequence of fields ina 
table are contained within the routine. 
The symbolic location of the tabie, 
acquired from the address analyzer routine, 
is written onto SYSPRINT with the table, 
using the line out and print routines. 


The TRACE STOP Routine (ITEGPAOOA) 


If the record type being processed by 
the action router routine is a TRACE STOP 
record, the action router routine passes 
control to the TRACE STOP routine (see 
Chart 59) via an xXCTL macro-instruction. 
The TRACE STOP routine examines the editor 
map (if it exists) to acquire the symbolic 
identification of the TRACE macro- 
instructions whose trace actions are halted 
by this TRACE STOP action. This 
information is moved to the current print 
buffer by the line out routine and written 
onto SYSTEST by the print routine. Control 
is returned to the editor router routine. 


The TRACE Routine (IEGNVOOA) 


Except for TRACE STOP, all TRACE macro- 
instruction records encountered by the 
action router routine result in a control 
transfer to the trace routine. (See Chart 


60.) This includes records generated by 
the TESTRAN interpreter’s trace start rou- 
tine. If the record is a trace flow or 


trace refer output, the problem program 
instruction that caused the record to be 
generated is indicated in the output record 
as it appeared in storage. 
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If the instruction was performed remote- 
ly by an execute instruction, it is indi- 
cated in its modified form along with the 
execute instruction. Registers involved 
and comments requested are also included in 
‘ the output record generated and moved to 
the print buffer by the line out routine 


and written onto SYSPRINT by the print 


routine. The trace routine links to the 
address analyzer, attribute analyzer, dump 
data, and dump panel routines. 


The TEST OPEN Routine (TEGPGOOA) 


The action router routine passes control 
to the test open routine (see Chart 61) 
when it encounters a test open type record 
aS its input. The test open routine finds 
the action table entry that corresponds to 
the record and extracts the information 
about the TEST OPEN macro-instruction from 
that entry. | 


The line out routine moves the data to 
the current print buffer, the print routine 
Writes the data onto SYSPRINT. When the 
test open routine is terminated, control 
returns to the editor router routine. 


The DUMP MAP Routine (IEGNGOOA) 


If the action router routine detects a 
dump map type record, it passes control to 
the dump map routine (see Chart 59) via the 
XCTL macro-instruction. The routine takes 
the data in the record, which shows the 
Storage configuration used by the program 
under test at its execution time, and 
writes it onto SYSPRINT. 


The line out routine moves the data to 
the current print buffer, the print routine 
writes the data onto SYSPRINT. At comple- 
tion, the DUMP MAP routine returns control 
to the editor router routine. 


The TEST CLOSE Routine (IEGPHOOA) 


A test close type record 
action router routine to pass control to 
the test close routine (see Chart 53) via 
the XCTL macro-instruction. This routine 
lists the TESTRAN interpreter TIA tables 
which the TEST CLOSE entry caused to be 
closed (deactivated). The routine uses the 
address analyzer routine to correlate the 
Symbolic name of the tables with their 
Storage addresses and uses the line out and 
print routines to move the data to the 


causes the 
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to other 


current print buffer and write it onto 
SYSPRINT, respectively. 


The routine also adjusts the editor's 
internal tables to reflect the altered 
status of the testing environment of the 
problem program brought about by the test 
close operation. For each TIA table closed 
by the test close routine, its correspond- 
ing entry in the action table list is 
zeroed. ; 


Exit from the test close routine is to 
the editor router routine via the RETURN 
macro-instruction. 


The DUMP CHANGES Routine (IEGNDOOA) 


The action router routine passes control 
to the dump changes routine (see Charts 62 
and 63) via an: XCTL macro-instruction when 
it encounters a dump changes type record. 
The routine uses the dump change list to 
determine if an earlier image of the stor- 
age area covered by this record exists. If 
such an image does exist, the dump change 
list points to its dump change table on 
secondary. storage. 


The dump change table entry indicates 
the address of the image, also on secondary 


storage. This image is compared byte-by- 
hyte and field-by-field with the image 
contained within the input record. If no 
variations exist between the current 
(input) image and the one on' secondary 
Storage, "none" is written onto SYSPRINT. 


If, however, a difference does exist, the 
changed areaS are written onto SYSPRINT. 
The new, or latest, image of the storage 
area becomes the new standard for 
comparison, and replaces the old image on 
secondary storage. 


control 
editor routines via the LINK 
Macro~-instruction. During its operation, 
this routine uses the symbol search rou- 
tine, the attribute analyzer routine, the 
editor message routine, and the root 
module's line out and print routines. 


The dump changes routine passes 


Exit from the dump changes routine is to 
the editor router routine via a RETURN 
macro-instruction. 


The DUMP DATA Routine (IEGNAOOA) 


The dump data routine (see Chart 61) is 
entered from the action router routine via 


an XCTL macro-instruction when the action 


router routine detects a dump data type 


record or via a LINK macro-instruction from 
the trace routine for a trace refer type 
record. In either case, the routine pro- 
duces output records that contain an image 
of a specified area of storage (at problem 
program execution time) with all possible 
labels and attributes indicated. | 


For a dump data record, this is the sole | 


‘purpose, but for a trace refer record both 
a "before" and an “after" image must _ be 
produced. The routine scans the action 


table entry that corresponds to the inter- 
preter TIA table entry whose interpretation 
caused the input record to be generated. 
It searches the entry for attribute over- 
riders for the data. Any such overriders 
found are stored in the root module's 
communications area. The dump data routine 
links to the symbol search and attribute 
analyzer routines to locate and analyze 
symbol table attributes, respectively. 


The data edit routines are called, as 
needed to process each tield defined by the 
attributes. | 


Exit from this routine is via the RETURN 
macro-instruction. For the trace refer 
record, the return is to the trace routine; 
for the dump data record, it is to the 
editor router routine. 


The DUMP PANEL Routine (IEGPPOOA) 


The dump panel routine (see Chart 61) 
receives control from the action router 
routine via an XCTL macro-instruction when 
the action router routine detects a dump 
panel type record. The record, as generat- 
ed by the interpreter, contains images of 
all 16 general registers, the floating 
point registers (where applicable), and the 
program status word (PSW). The register 
selection mask in the action table is 
interrogated to determine which of the 
register images is to be printed. 


The dump panel routine links to the data 
edit routines to convert the data in the 
registers to printable form and expands the 
PSW. The root module's line out and print 
routines are used to move the data to the 
current buffer and to write the data onto 
SYSPRINT, respectively. 


Exit from the dump panel routine is to 
the editor router routine via the RETURN 
macro-instruction. 





The Address Analyzer Routine (IEGSNOOA) 


The address analyzer routine (see Chart 
64) is entered from the other output rou- 
tines via a LINK macro-instruction. It 
identifies a given loaded address by its 
assembled address, its symbolic name, and 
its CSECT name. This routine obtains this 
information by searching the map, and sup- 
plies it to the print buffer via the line 


out routine, aS requested by the calling 
routine. Following its execution, control 
passes to the calling routine via _ the 


RETURN macro-instruction. 


The Symbol Search Routine (IEGSQOOA) 


The symbol search routine (see Chart 64) 
is linked to by the other editor routines. 
It. finds the attributes of a data item for 
which the calling routine can supply the 
loaded address. The routine searches the 
editor map and the corresponding symbol 
table for .these attributes and sets a 
pointer to them. 


If the loaded address supplied for a 
data item is not at the beginning of that 
item, but at some offset from the begin- 
ning, the symbol table attributes (length, 
duplication factor, etc.) are altered to 
reflect this. For duplicated items, the 
duplication factor is altered to properly 
reflect the portion of the item from the 
offset to the end of the item. For multi- 
ple DSECTs, an offset from the beginning of: 
the first DSECT is converted to an actual 
offset into the correct copy. 


The attributes for the data, as deter- 
mined by this routine, are made available 
to the calling routine. 


Exit from the symbol search routine is 


Via a RETURN macro-instruction to the call- 
ing routine. 


The Attribute Analyzer Routine (IEGSROOA) 


The attribute 
Chart 65) is 


analyzer routine (see 
linked to by other output 
routines (dump data, dump changes, and 
trace.) This routine correlates the attri- 
butes of a data item given to it at 
assembly time or overriders provided by the 
user with the data item. It maintains the 
relationship, between data and its attri- 
butes, that was established by the symbol 
search routine. It does this by continual- 
ly updating pointers so that the proper 
attributes continue to be applied to data 
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and by causing the data to. be converted to 


hexadecimal format when input data comes 
from the subsequent CSECTs. The routine 
also initiates the writing of a print 


buffer when a line is filled and identifies 
each print line with its assembled and 
loaded addresses. Attribute pointers are 
Maintained in the root module's communi- 
cation area. This routine links to the 
appropriate data edit routine through its 
edit linkage subroutine (IEGEDIT). 


Note: The TESTRAN editor uses a system of 
three print line buffers. The format of 
the printed output for a specific type of 
test output data can be found in the 


publication IBM System/360 Operating Sys- 
tem: Control Program Services. 


The Data Edit Routines 


The data edit routines consist of eight 
routines that convert data from one format 
to another and prepare it for printing. 
These routines are linked to either by the 
attribute analyzer routine or by the DUMP 
PANEL routine. The calling routine remains 
resident in main storage during the opera- 
tion of a data edit routine. 


If a 
tinuation record, control passes 
data edit routine to the editor router. 
The editor router gets the continuation 
record and passes control back to the data 
edit routine. The amount of data converted 
by an edit routine is dependent on the 
item*s length attribute as stored in 
ITEGCMARA within the communications area of 
the root module. All results from data 
edit routines are in the EBCDIC print 
character form. The actual moving of edit- 
ed data from the work area to the print 
buffers is accomplished by the attribute 
analyzer routine in all edits except zoned 
decimal, alphameric and hexadecimal (over 4 
bytes). 


record being processed has a con- 
from the 


Hexadecimal Edit Routine (IEGSU01Z): The 
hexadecimal edit routine (see Chart 66) 
converts 4-bit hexadecimal values to the 
corresponding EBCDIC character. The rou- 
tine moves the substituted EBCDIC charac- 
ters to the current print buffer and 
returns control to the calling routine. 
The processing is done one field at a time, 
with control returning to the calling rou- 
tine after each field is processed. 


snstruction Edit Routine (IEGSU06Z): The 
anstruction edit routine (see Chart 66) 
replaces the operation code portion of an 
instruction image (in its internal machine 
coded form) with the assembler language 
Mnemonics for that instruction. 
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The oper- 


and portion of the instruction image is 
converted to the EBCDIC characters for the 
hexadecimal values they represent. If a 
TESTRAN SVC instruction, that was inserted 
by the interpreter into the user's program, 
is encountered, its image is placed into 
the print buffer so that it appears direct- 
ly below the instruction bytes it displaces 
when the buffers are printed. | 


The correlation between SVC and dis- 
placed instruction bytes is made through 
the use of the editor's reference table. 
If no reference table exists, only the SVC 
instruction will be printed. If the rou- 
tine encounters an invalid operation code 
hyte, it is placed into the print buffers 
in its 2-hexadecimal-character form with 
the two characters placed side by side and 
flanked with asterisks in the printed out- 
put. The routine will retain control for 
the area defined by one entry in the symbol 
table, or for any area with an instruction 
overrider. 


Alphameric Edit Routine (IEGSU40Z): The 
alphameric edit routine (see Chart 66) 


moves a specified number of EBCDIC coded 
alphameric Characters into the current 
print buffer and checks to determine wheth- 
er or not each character is a valid print 
character. If a character is not a valid 
print character, this routine converts it 
to its 
and places the two hexadecimal characters 
into the print buffers so that they will be 
printed one above the other. 


The routine is linked to either by the 


dump panel routine or by the attribute 
analyzer routine. At the conclusion of its 
operation, control returns to the calling 
routine. 


Binary Edit Routine (IEGSU50Z): The binary 
edit routine (see Chart 67) converts 


bit within each specified byte into its 
equivalent decimal value, and moves’ the 
decimal character (or characters) into the 
current print buffer. The routine leaves 
the result of its conversion of the last 
specified byte in the work area. The 
calling routine moves the last byte'’s con- 
verted value into the print buffer. 


zoned Decimal Edit Routine (IEGSU602Z): The 
zoned decimal edit routine (see Chart 66) 
checks the validity of the sign of the 
zoned decimal number to be processed. If 
it is a valid sign, this routine places 
that sign ahead of the number in the print 
buffer. The digits are moved to the print 
buffer and any found to be invalid are 
converted into their 2-hexadecimal- 
character equivalent and placed into the 
print buffer so that they are printed one 
above the other. 


2-hexadecimal-character equivalent 


each 


Lf» 


If the length of the input data field is 
greater than 16 bytes, control passes to 
the alphameric edit routine via an XCTL 
macro-instruction. Otherwise, control 
returns to the calling routine. 


Packed Decimal Edit Routine (IEGSU70Z): 
The packed decimal edit routine (see Chart 
66) converts or “unpacks" data in packed 
decimal form into a zoned decimal equival- 
ent. This routine does not perform a 
validity check of the data. If the length 
of the input field is greater than 106 
bytes, control passes to the hexadecimal 
edit routine via an XCTL macro-instruction. 


Fixed-Point Edit Routine (IEGSU80Z): The 
fixed-point edit routine (see Chart 51) 
converts binary numbers to decimal numbers. 
This routine operates on binary numbers 
with a scale that is equal to, greater 
than, or less than zero. Processing of the 
number by the routine depends on the scale, 
with a different procedure for the 3 varia- 
tions in scale. The converted output (in 
the form of decimal numbers) is placed into 
the print buffer. Control then returns to 
the calling routine. 


Floating-Point Edit Routine (IEGSU90Z): 
The floating-point edit routine (see Chart 


65) converts a floating-point number in its 
internal hexadecimal 
decimal number and places the decimal 
ber generated into the current print buf- 
fer. The actual conversion routine follows 
several basic steps, 
on whether the 


num 


floating-point number is 
short or long. The relative scale of the 
number also affects the processing flow. 
More processing is necessary for larger or 
smaller numbers than for mid-range numbers. 


It is possible that the separate job 
step of editing TESTRAN test output data 
may also be done on a separate computing 
system. It is possible that a computing 
system without the floating point feature 
might be called upon to edit floating point 
data. For this reason, only the standard 
instruction set is used in the floating 
point edit routine. | 


TESTRAN EDITOR CONTROL FLOW FOR SAMPLE EDIT 


Figure 


through the TESTRAN editor for a sample- 


block, 


coded form into a 


some of which depend © 


5 depicts the control flow. 





case editor run. The Sample is a 
relativeiy simple one in which the problem 
program was tested with TEST OPEN, TEST AT, 
and TEST CLOSE test control macro- 
instructions and a DUMP DATA test action 
macro-instruction. 


As Figure 5 indicates, initial entry to 
the TESTRAN editor is made into the start 
routine. After it initializes the program, 
the start routine transfers control to the 
editor router routine. This routine reads 
the input records from SYSTEST and passes 


control to the action router unless’ the 
record iS a continuation record. Fora 
continuation record, the editor router 


passes control directly back to the routine 
which had been processing the previous 
portion of the record. 


When . the action router gets control it 
examines the record type to determine which 
routine is to be given control. The 
records to be processed in this sample edit 
are indicated within the action router 
sequentially from top to bottom, in 
the succession in which they are read. 


Opposite each record-type name are 
blocks representing the routines used to 
process that record type. In some cases, a 
routine in the longer sequences may trans- 
fer control back to a previous routine 
which is still resident in main storage. 
In other instances a routine that was used, 
early in the processing sequence, has to be 
loaded into main storage again. 


Figure 5 shows that the records 


essed are: 


proc- 


Symbol Table 
CESD 

Relocation Table 
TIA Table 
Reference Table 
Test Open: 

Dump Data | 

Test Close 

End of Data 


The end-of-data processing is initiated 
by an end-of-data-set condition rather than 
a record. 
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Flowchart representations of the rou- 
tines described in the text are printed on 
the following pages. The numbering system 
used to identify the charts is as follows: 


10 through 15 - TESTRAN macro-definition 
processes. 





CHARTS 


30 through 43 - TESTRAN interpreter 


routines. 


50 through 67 - TESTRAN editor routines. 


Charts 
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Chart 10. MTESTRAN Macro-Definition - TEST 
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Chart 12. TESTRAN Macro-Definition - 
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Chart 34. TESTRAN Interpreter 
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Chart 36. TESTRAN Interpreter 
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PGCSTNAM Vv 
HREHREGSEREHRUEHE NH 


* * 
% MOVE CSECT #* 
* NAME TO HK 
+ BUFFER * 
* * 
KREKRBKEKAMRHKRAREHRREH 


v 
REKAKHS REAR EAHEE 
* * 
# PRINT 2ND~ # 
* LINE OF * 
* OUTPUT # 
% * 
MEERA EEHEREEK 


Vv 
ERE ISHAM REE 


* * 
* RETURN * 
* * 


KTKREEKAEKRERKKKE 
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Chart 62. TESTRAN Editor 
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HERE ADEHEHREEERE 


* * 
* ITEGNDOOA * 
* * 


HRERKEEKERKKEHKEEREE 


DUMP CHAN 


IEGNDOILA Vv 


REREKGHL UMMM 
*% INITIALIZE * 
* OVERRIDERS * 
* AND LOCATE % 
* CHANGE DUMP * 
* LIST * 
HEKKHKRHEEEKKKEREEE 


HHH 

* * 

* C2 *-—> 
* * 


HEE 


ITEGNDOSA Vv 


HRAHKRECOKRKERMEKEEEKE 


* * 
* COMPARE * 
ace emcees” dl LOADED 4 
* ADDRESS * 
* * 


HKEKRKEABETHEKREKREKE 


GES 


SRR | 


Vv 
HHHHED | KKH KREEK D2. "ee HREKHO GHEE HEEH 
*#* TEGNDO4GA 62A5* o* Ke * TEGNDOGA 63A4*% 
H—X—¥—K—H—H—H—H—KUNMATCHED 0* %e UNMATCHED #—*#—#—#=#—%—#—#—*% 
* PRINTs SAVEs #< He RESULT o t—————_——— > * UPDATE * 
* AND UPDATE * INP te o* CHG * CHG * 
* INP POINTER * Fe o* * POINTER * 
EHH KEHHEE KEKE EE He o% EKER EE EEE EERE 

* EQUAL 

eVe 
HRHHEE 1] HEME EREE E2 %, HRKEHE ZEEE RKHKEEN 
*TIEGNDOSA 63A2* o* te *® IEGNDOGA 62A5* 


Ke HX K— HF —- F— K¥—-¥E—- KF— ¥ E 
* UPDATE ¥< 

* INP * 

* POINTER * 


HKEKKHREKEKKEERKREKREXN 
| 
| 


See a eee, 


Q e«* COMPARE *. N 


OT H—H— H—K— HHH HE 


#e DATA FIELD «*————————>* PRINTs SAVEs * 
Fe o* EQ * AND UPDATE * 
Fe o% * INP POINTER ¥* 
He of RRR KEHHERER EEE 

# 


HRKMRKE DHE EHR EEE 
* ITEGNDOGA 63A4* 


HHH — HAH — KKH HE 
>* UPDATE #< 
* CHG * 
* POINTER * 


HHREKHKERHKEKRKEHEREE 


HK 


ok ek 
‘@) 
N 

mK ek 


REKEK 


z 


RHE AS EHH REEEH 


* * 
* ITEGNDOGA * 
% % 


HHREKKKAKKRERKKEEE 


SUBROUTINI 
TO IEGNDO! 


V ; 
HHEKEHHSHMEREKKKEKE 


% *% 
* SET * 
* CHGSW * 
* ON * 
* * 
HRERHKKREHEKHKEKRKHEKRE 


Vv 
HRHEHH CSE HEHE 
*TEGSQOOA 64A4* 





H— KR —H— H—H— HHH 
* LOCATE * 
* SYM. * 


* ATTRIBUTE * 
HHH HE TE ETE HE HE EE EE HE 


| 
Ve 
DS *. 
e* IS *e 
NO e«* FIELD CUT *. 
r—*e BY CONT. o* 
* 





<o— 


| 
| RHEHEHRES RHREKRHHEX | 
| *IEGNDOSA 63A2* 
HHH — HH HH HH 
* CAUSE INP * 
* CONTINUATION * 
*RECORD TO READ * 
| HERKEN EEE HHH 
| 
| [ 


v 
HRHEKKE SME HEHE 
*IEGSROOA 65A2* 
X—KF—HK—K— K— KF —HK—H—* 

|_ ss EDIT % 
* FIELD * 
*% * 
KRHRKHHKHHHKKRKEHRHHREE 





V 
KHRHHHGS EEE EERE EE 
* TEGNDOSJ 63A2* 


K— He Ke Km K— KE H— H— HK 
* DO NOT # 
* UPDATE INP * 
* POINTER * 


HEHHKHKKKHKEKHENE 


| 
! 
| 
Vv 


HHEKHS HHH HHHEH 
* EXIT VIA * 
* LINK * 
* REGISTER * 


HEHEHE REREHEE 


Chart 63. TESTRAN Editor 
HHL AD AEM URHEKEHE 
*% * 
* IEGNDOSA % 
* 
HRHHRHEHRHHHHRKRKEKEKE 
SUBROUTINE 
| TG IEGNDOOA 
| 
HHKKHBGPKHKHKHKKEKE 
* * 
* INCREMENT INP * 
* TO NEXT + 
* FIELD + 
* * 
HERE HKHRH HH EHH HKMHRE 
| 
| 
| 
t 
Ve IEGNDOSB 
C2 He KHHEKKHCZHHHEHKHHHKN 
HRUEERC |] KHKKHKRKKE e* He * FLUSH PRINT * 
* EXIT VIA # NO e* END OF *. -EOD *BUFFERSs WRITE * 
* LINK %#<————_————-*. PROCESS-— o* >* LAST CHG BUF *< 
x REGISTER * ¥e ING o* * AND SET * 
KRHRKEHRRBREHRKKRKREUHEH He ex * CHG LIST *% 
He e* ee ee ee ee 
* INP | 
[cONTTNUATIGN | 
| | 
| 
| | 
| | 
| 
| 
IEGNDOSD Ve 
Ke 
o* He 
| o* He ON 
>% ; CHGSW .*-——— 
He o* 
Xo e* 
He ot 
* OFF 
| 
{ 
| 
| 
| 
V 
HEHKHF ZFRHRKRKERKEH 
* TEGMEOOA 5054 
Hm HH — HK KH — H— HK — H— HK 
% BAL TO 


* ROUTER TO * 
* GET INPUT * 
HAHN EKER 


Vv 
HKKECZREKHHRHKKE 

* EXIT VIA * 
3 LINK * 
* REGISTER * 
KRHAKEHKHEAKUEHKHE 


HREK AGREE KEHEH 


+ 
* IEGNDO6A * 
* . * 
eee ee eee ee ee 


SUBROUTINE 
TO YIEGNDOOA 


HREHKKGGKKAKHHEKKK 
* 


* 
#% INCREMENT CHG * 
# TO NEXT # 
% FIELD * 
*& . 
* * 


HHH KEKHERHEREK 


I 
eVe 
C4 %. 
ot He 
ECD e* END OF ¥e 
*#. PROCESS-— e* 
*e ING ox 
%e e* 
He ex 
# CHG 
| CONTINUATION 


NO 


TEGNDOG6C Vv 
HHEKEKOGHRHKAHHEHER 


% 
* LOCATE AND # 
* READ NEXT ¥* 
* CHG BUFFER * 
* * 
& * 


MRE KREGER EERE 


HHKHKKEGKHKEEEEKRKE 
* * 
* WRITE CHG ¥* 
>* BUFFER AND ¥* 
* RECORD * 

% 

* 


* IN LIST 
HERE MK HHH EHH 


ert eae rei 


HHEEECHHRHEKEHKHKEH 


* EXIT VIA 


> 


LINK 


* REGISTER 


HEAR HEKRHRERKHKE 


KRHHEED SRHEKRKEEK 


* EXIT VIA 


> 


LINK 


_* REGISTER 


REBECA H 
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t 
* 
* 


% 
* 
% 


Chart 64. 


HEHE A] RENEE EEE 
* _ 
* IEGSNOOA * 
* * 

HEHHRERHERERHERE 


ADORESS 





| 
| 


V 
HRHKKHEGY LHRH EH 
*IEGSQOOA 64A4* 
HHH H— HHH HE 
* LOCATE * 
* SYMBOL * 
* * 
HEH EE EE HE HE EE HH EE EH 





NO .* te 
cra * SYMBOLS o%* 
*% 


HHKEED 1] HERR HHEEEE 
* IDENTIFY * 
* LOCATION * 
* WITH * 
* SYMBOLIC * 
* ATTRIBUTES * 
HEGRE EEE HEE HEH 


IEGIDO3A VV 
HEHKRNE |] PHM 
% *% 
% * 
>* MOVE LOCATION * 
*IDENTIFICATION * 
* TO OUTPUT ¥* 
HRREHHRKARKHRHHRKRRMRKEHEH 

| 

| 


Vv 
HERE LRH EH 


* * 
* RETURN # 
* * 


MERE REHH RMN EE 
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ANALYZER 


% 
*% 


TESTRAN Editor 


HEHEHE HEN 


RETURN 


KHEREKEREKKHEKKEEE 


* 
#< 
* 


IEGSQS50 
HRKHE BZ RRA EHH 


* INITIALIZE * 
* COMARA * 
* FOR NO ¥< 
* SYMBOL * 
* PROCESSING * 
ERNE EH EEE REM HEEE 


HH HHH CZ HEE HH 


* SEARCH * 
* MAP BY * 
* LOADED #< 
* ADDRESS * 
* * 
KEKE HERE EE ERE 


HERE AG REHRKHEREX 
* * 
* ITEGSQOOA * 

* 


HREKRKKREHKTHEKHEKKKE 


SYMBOL. SEARCH 


IEGSQO1 oVe 


B4 Ke 
o* _ Be 
NO «* He 
Be MAP o* 
e e 
He ex 
He oo & 
* YES 


IEGSQO2A~ eVe 


e* Ke 


OTHER o«* *. DSECT 


Xe TYPE o* 


* BLANK 
COMMON 


ITEGSQIS Vv 
HHEKEKDG KEKE HHRHEEE 


* 


* 
* SEARCH MAP #* 
* BY ASSEMBLY ¥* 
* NUMBER * 
* * 
* * 


HREKKRKHEKREKREHKKE 


IEGSQ90 Vv 
HRHEKEG RHEE REREEKE 
* LOCATE * 
* SYMBOL * 


>*ATTRIBUTES AND *< 
* INITIALIZE * 
* COMPARA * 
HR ERE HEE 


Vv 
HERA ARKH KHEKEKKE 
* * 
* RETURN * 
* * 


HREKRAKEKKEKRKKEKRKREE 


IEGSQO3 
HHKHKHCS HEHE REEEE 
* 
* SEARCH 
>* MAP BY 
= NAME 


KRHEKKKRKRKRKHKHKHEKREE 


* 


* 
* 
* 
* 
* 
* 
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HEHEHE | HHH HE 
*#INITIALIZE FOR * 
* CONTINUATION #* 
* PROCESSING #< 
*SAVE REMAINDER * 
* SET POINTER #* 
HFG ME EEE HH HH 


| 

Vv 
HHRMEL |] EHH R HEHE 
*#IEGMEOOA SOE4* 
H-H—H—H—H—H—H—H—H 
* BAL TO * 
* INPUT * 


* ROUTER * 
MERE HHH HH 


IEGSSO7 Vv 
WHERERG |] KREME 
% * 
* SET LENGTH # 
# SET DATA # 
* POINTER * 
% * 
PEP ee ee ee ee 2S 


TESTRAN Editor 


EE ETE AD HE EE 





# * UPDATE * 
# IEGSROOA x 
* 
MHEHHKHKRHAKKAKEHRE * 
| BMHEHMKRREKEKRAKUEE 
| ATTRIBUTE | 
PANALYZEK | 
| 
IEGSRO1 Vv oVe 
KKRHKEHPDKEKHKHHHEHRER B3 Re HEKHKGGHEHKHRKRKHHK 
* * et te. * + 
# INITIALIZE * o* NEED #. YES * * 
#* DATA LOCATION * He NEW SYM ° *¥—_—_______>* GET NEXT # 
# AND LENGTH * *. BUF o* * SYM BUF # 
* * te et * * 
MERMRHKRTREMRHHRKKRKEE %e ot HWE MRR KRHK EKER 
| | NO | 
I< 
IEGSR12 oVe IEGSR10 oVe 
He Ke HHEKERCGRHERHKRHENE 
o* he ox Xe * % 
o* *e YES o* %e YES * INITIALIZE * 
#.e SYMBOLS *———_—__—__>*,. CLUSTER o ¥-——_———>* FOR CLUSTER ¥* 
He * He o* # PROCESSING * 
te, ox te ot * * 
Re o & He et RREMRURERHKERKEHE EK 
* NO NO | 
| ees, 
| 
v Vv 


HHNHHO DRAM HME HEH 
* 


+ 
* INITIALIZE  #* 
* FOR NO SYMS-) * 
* PROCESSING # 
* * 
* * 


HRKERKHHKEKMAEKEKE 


oe 
E2 te 
*% % 


oe e 
YES e* CON- #e 


*%e TINUATION e#< 


*.e RECORD e# 
¥, ot 
He ot 

* NO 





Vv 
HEHE Ot ee HE Ee 
7 


* 
* SET EXIT tt 
% % 
* SWITCH ON) #* 
* % 
* & 


MWHEHMRKMHAERHPERH 





IEGSR16 
HUE HAZEN EHH EE 
* * 


% 

* SYM #E 

* POINTER * | 
& 

* 


HHH OSH HHH HHEHH 
* INITIALIZE * 
* SYMBOL * 

>* ATTRIBUTES OR * 
* OVERRIDERS * 
+t + 
FEE TEE HE HH HH HE HH 


fo soy eS ee er Ge Soe Spe a ee ee ee ee 





| NO 
IEGSSO6 Ve IEGSSIOA ote 
, E3 Ke E4 Ke 
°* DATA ¥*e . o% * 
YES e«* BUFFER *e NO o% 
He EXHAUSTED e *-———} He SYMBOLS o# 
MORE te o% | e o% 
te o* He * 
te ot | Heo ok 
* YES A 
co | | 
OFF 
IEGSS22 Vv ITEGSS10 o%e 
HHKAKE SHEE KR EREH F4 He 
* a | e* He 
* SET EXIT % o% EXIT He 
% * te SWITCH o 
* SWITCH ON * Re ot 
* * He o* 
HARK RKAEREREERER 4 te ot 
| A 
| 
IEGSSO7Z | 
HURAHEGRHRAEHHHERERE 
% ca 
* UPDATE * 
>< * DATA * 
* POINTER * 
es % 
HE EM TE IEE EE EE 
A 


Vv 
MMT HE EEE EE ERR KEKE 








* 9 
# LINK TO ONE OF THE tt 
* FOLLOWING EDIT ROUTINES # 
* t 
% * 
* TEGSU01Z HEX 66C2 * 
# TEGSU06Z INST 66G1 * 
# TEGSU40Z ALPHA 66C5 * 
# T[EGSU50Z BINARY 67AL * 
# TEGSU60Z ZONE DEC 66A4 * 
* YTEGSU70Z PACK DEC 66A1l * 
# TEGSUB80Z FIX PT 51E3 * 
* TEGSU90Z FLT PT 67A3 * 
i > 
* % 
# NAME FUNCTION CHART * 
& + 
‘SE ME SE Ee STE BG ESE AE SE SE GE SE SE SE SE SE St EE SE EEE SE EE SE SE EE EE EE 


te YES o 


e* DECREMENT *e 
>*.e AND TEST 


*DUP FACTOR * 
* 


%e 
He of 
* 


KRHEKESKKKERHREE 


+ 
>* RETURN 
* 


HEEKKEMEKEEREEHEE 
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* 
* 
# 


Chart 66. 


HERA] HEHEHE REN 
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* TEGSU7OZ * 
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HERMAN EEEHEREEE 


PACKED 
OECIMAL 
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Bl He 
e* SIZE *e 
o* MORE 
ee THAN o* 
%e 16 o* 
*-BYTESe* 
He ot 
* NO 


ZIEGSU7TOA Vv 
HEREC LE RKHRHEENEH 
* MOVE TO OUT- #* 
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* SIGN TO FRONT * 
* AND CHECK * 
* VALIDITY |. * 
HERE REEEERE 


| 
| 
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HHHHED | EHH 
* EXIT VIA. * 
* LINK * 
* 


* REGISTER |. 
HERG E EERE EE EEE 


RERNG 1 HHH HEH 
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* IEGSUO06Z * 
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HREMERARKEAHHEREE 


INSTRUCTION 


IEGSUO8 Vv 

MEME DERE EERE 

*% LOCATE NEXT #* 

*% INSTRUCTION», #* 

>* CONVERT TO HEX * 
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HEHEHE ERE REED 
HERE 
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HHH 
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* * 
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HAERERERERMREEERREE 
ITEGSU16 oVe 
K4 te 
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>to DONE o* 
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te ot 
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Vv 
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>* ITEGSU40Z * 
* * 


HKRERKKKMEKHKKRKKANE 
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HREKRKEKHEKREEEREHE 
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* LOCATE NEXT #* 
*AREA TO PRINT». * 
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HREERHEAMRERHERAEEEE 


TEGSU40C_ eVe 
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o* He 
VALIO He 
PRINT o% 
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HEHEHE SHEE HEHE 
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* EXIT VIA * 
* LINK * 
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HREEK SHEE EERE 
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* LOCATE NEXT * 


* BYTE AND * 
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HK HKHEHHHHE 
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* 


KHEKKEHEKEKRKEEKEEKHE 
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: Vv 
KHHKEKEHZRERKEKRKREKRKE 
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* FORM * 
* INTEGER * 
* * 
ERNE KHEREE ERE RENE 
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HHHHHCDHREHRHHEEHE C3 %e HEHE CGMEREEERERE 
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* 2 TO THE * ®e o* * BY 2 TO THE * 
* S POWER * Re o* * S POWER * 
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APPENDIX A: . TEST INTERPRETER ACTION (TIA) TABLE ENTRY TYPES 


This appendix contains pictorial representations of each of the 23 TIA table entry 
types. The "A" (address) and modifier fields appear in many of the entries and are 
explained fully at the beginning of this appendix and merely named in the individual 
entry presentations. 


A FIELD EXPANSION 


The A fields included in the TIA entries are expanded as follows: 


a aE i ac a ac osc ee ee eC ae Tyee te ie 1 
| OR | L | AL | 
Ee eye REN ney Wert Nee eT SO ae ees gee PROCES Lat en GE eer en ene eee REE SON ie SEO eeaE ee er anne mec a eTN J 
OR (1 byte) Organization Byte L (1 byte) Length 
Bit 0 - "L" Field Flag If the "AL" field contains a literal, 
1 = Present this field contains the length of that 
0 = Not present literal. 


Bit 1 - Not Used 
Bits 2,3 - Type of “AL" Field present 


00 = Literal AL (1-255 bytes) 
01 = 24 bit absolute address This field will vary depending on bits 
10 = 16 bit base displacement 2and 3 of the organization byte as 
address follows: 
11 = 1 byte register number 
The contents of this register 
are to be used aS a value 00 Literal - Length will be specified 
rather than an address. This in the"L" field 
type will only appear in the 01 24 bit Absolute Address 
SET family of macros and in 10 16 Bit Base/Displacement Address 
the TEST WHEN and TEST ON Bits 0-3 - Base register 
macros. Bits 4-15 - Displacement 
Bits 4-7 - Index Register Number 11 1 Byte Register Number 
0 = No indexing Bit 0 | 
1-15 = The number of the general - 1 = Floating point 
register to be used for ' 0 = General 
indexing the address con- Bits 1-3 - Not Used 
tained in the "AL" field. Bits 4-7 - Register Number 
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MODIFIER FIELDS S, 


In the variable field descriptions on subsequent pages, modifier fields are defined as \ 


follows: 

2 Bytes 
.------------- 
| S | 
bee er See 


P, FO, L 


[| P {| 


1 Byte 


Poti Nig te Oe ieee, | 


FO 


bee evened. (booed 


S (2 bytes) Scale Modifier | 
A two byte signed integer field which specifies the number of places the decimal or 
binary point is to be moved to the left. 


~P (1-byte) Output Selection Code 
A one byte field containing a hexadecimal coded value of 1-8 used by the TESTRAN 
Editor to determine the processing of test data. 


80 Output 
4Q Output 
20 Output 
10 Output 
8 Output 
4 Output 
2 Output 
1 Output 


Selection 
Selection 
Selection 
Selection 
Selection 
Selection 
Selection 
Selection 


FO (1 byte) Format Modifier 
00 Character 
01 Hexadecimal 
02 Fixed Point? 
03 Floating Point? 


04 Packed 


Decimal 


05 Zoned Decimal 


OA Binary 


OB Instruction 


L (2-byte) Length 


Modifier 


Code 
Code 
Code 
Code 
Code 
Code 
Code 
Code 


1 


ONNU £WN 


2 Bytes 


en 71 


| L | 


eee rd aren RTE 


Overrides any previously defined length attributes for the data referred to by the 
macro-instruction. 


hie nis tee ECs Sy eras Gwen Ge ene eee Gee eS eee qo ce ee ee eee ee ee 


1Length will always be present to distinguish between half-word and fulli-word fixed point 
and between short and long floating point. 
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DUMP DATA ENTRIES 


T (1 byte) Type Entry 
06 for DUMP DATA 


ID (1 byte) Identification 
The number assigned to this macro- 
instruction at expansion time 


LN (1 byte) Length 
The length of this entry in bytes 


A1,A2 | 
These fields contain the from and to 
addresses. 


P,S,FO,L (S,L=2 bytes;. P,FO,=1 byte each) 
These Fields specify an output 
selection code for output generated by 
this Statement and overriders for 
attributes contained in the symbol 
table. Tf no symbol table exists, 
these are attribute specifications. 


NM (2-9 bytes) Name Modifier 
Byte 1 - Length of Symbolic Name 
Bytes 2-9 - Symbolic Name 


(1 


DS (5-12 bytes) Dummy Section Name 


This field consists of 5-12 bytes of 


data as follows: 

Byte 1- Length (1-8) of the 
dummy section name 

Byte 2 - Repeat Count (1-255) 

Bytes 3,4 - Base/displacement 
of dummy Section | 

Bytes 5-12 - Symbolic name 
section 


byte) Flags 
Bit 0 - “P" Field Flag 
1 Present 
0 Not present 
Bit 1 - "S" Field Flag 
Present 
Not present 
Bit 2 - "FO" Field Flag 
1 Present 
0 Not present 
Bit 3 - "L" Field Flag 


Or 
Hol 


Hel 


1 = Present 
0 = Not present 
Bit 4 —- "NM" Field Flag 
1 = Present 
0 = Not present 


Bit 5 - "DS" Field Flag 
1 Present 
0 Not present 

Bits 6,7 - Not Used 


symbolic 


address 


of dummy 
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DUMP CHANGES ENTRY _ 


re a ee 
| T | ID| IN| AL | A2 | P | ss 


LPS DR eee he ee ee Re pe ee re eS a A pe ee Or for ee er re ae 


[Fo{[ L | NM r DS [Fr | 


L__-__1L--~ —-1- —--1——-——-—-1-~ ~~ -1-- ~~ 1 + LL Ld 


T (1 byte) Type Entry 
OE for DUMP CHANGES 


ID (1 byte) Identification 
The number assigned to ens 
instruction at expansion time 


macro- 


LN (1 byte) Length 
The length of this entry in bytes 


A1,A2 
These fields 
addresses. 


contain the from and to 


P,S,FO,L (S,L=2 bytes; P,FO,=1 byte each) 
These fields specify an output 
selection code for output generated by 
this Statement and overriders for 
attributes contained in the symbol 
table. If no symbol table exists, 
these are attribute specifications. 


NM (2-9 bytes) Name Modifier 
Byte 1 - Length of Symbolic Name 
Bytes 2-9 - Symbolic Name 


DUMP MAP ENTRY 


Pace ot ee Fe ee ee es A Sy es ae a ee ee eet eg Oe et 
l T | ID l LN | P | 


Seo a cae a ee ee Nae 
T (1 byte) Type Entry 

12 for DUMP MAP 
ID (1 byte) Identification 


The number assigned to this 
instruction at expansion time 
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macro 


DS (5-12 bytes) Dummy Section Name 
This field consists of 5-12 
data as follows: | 
Byte 1 - Length (1-8) of the symbolic 

dummy section name | 
Byte 2 - Repeat Count (1-255) 
Bytes 3,4 - Base/displacement 
of dummy section 
Bytes 5,12 - Symbolic name 
section 


bytes of 


address 


of dummy 


F (1 byte) Flags 
Bit 0 - "P" Field Flag 
1 = Present 
0 = Not present 
Bit 1 - “S" Field Flag 
Present 
Not present 
Bit 2 - "FO" Field Flag 
Present 
Not present 
Bit 3 - “"L" Field Flag 
1 Present 
0 Not present 
Bit 4 - “NM" Field Flag 
a: Present 
0 Not present | 
Bit 5 - "DS" Field Flag 
1 Present 
0 Not present 
Bits 6,7 - Not Used 


QF 
Hol 


or 
tou 


LN (1 byte) Length | 
Length of this entry in bytes 


P (1 byte) Selection Code 


Specification 


Output 


aS 


DUMP PANEL ENTRY 


ec aac Dara a at aa aa a a aaa i a aac i ee a a ee ala 1 


{ T | ID | IN | RR1 [| RR2 | 


RRn 


eee ey Oe ene Serna Bane eee ne a ae ae ec eee 1. —— —— be hb re i a ee ll a ace ahs ee J 


T (1 byte) Type Entry 
16 for DUMP PANEL 


ID (1 byte) Identification 
The number assigned to this macro- 
instruction at expansion time 


LN (1 byte) Length 
Length of this entry in bytes 


RR1-RRn (1 or 2 bytes each) 
Register request. Length of each of 
these entries depends on the first 
four bits as follows: 


Bits 0-3 =1 
Individual general register 


request. Length of entry is one 


byte. Bits 4-7 specify general 
register to be dumped. 


Bits 0-3 = 2 
Individual floating point register 
request. Length of entry is one 


byte. Bits 4-7 specify floating 


point register to be dumped. 


Bits 0-3 = 4 

Range of general registers request. 

Length of entry is two bytes. 

Bits 4-7 - First general register 

- Of range 

Bits 8-11 - Not used 

Bits 12-15 - Last yeneral register 
of range 


Bits 0-3 = 8 

Range of floating point register 
request | 

Bits 4-7 - First floating point 
register of range 

Bits 8-11 - Not used 

Bits 12-15 - Last floating point 
register of range 


P,S,FO,L (S,L=2 bytes; P,FO=1 byte each) 


These fields specify an output selec- 
tion code for output generated by this 
Statement and overriders for attri- 
butes contained in the symbol table. 
If no symbol table exists, these are 
attribute specifications. 


bytes) Flags 
Bit 0 - "P" Field Flag 
Present 
Not present 
Bit 1 - “S" Field Flag 
Present 
Not present 
Bit 2 - “FO" Field Flag 
Present 
Not present 
Bit 3 - "L" Field Flag 
1 Present 
0 Not present 


QrF coF oF 
Hit toil 


Bit 4-7 - Not Used 


Bits 8-15 - Count of "RR" Fields 
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DUMMY COMMENT ENTRY 


(Sa ee a aa are aaa ae Saar 1 

| T | ID | WwW | | P | F | 

Ge NN LAS See eee OY Mee Re me Note EaP aE ee OTT AY ODP eT me Nee eT aE 5 ee eee eee eRe J 

T (1 byte) Type Entry P (1 byte) Output Selection Code 
1A for DUMP COMMENT Specification 


ID (1 byte) Identification 
The number assigned to this 
instruction at expansion time 


macro- 


LN (1 byte) Length 


F (1 byte) Flag Byte 
Bit 0 - "P" Field Flag 


Length of this entry in bytes 1 = Present 
| | 0 = Not present 

C (variable) Comment Bits 1-7 - Length in Bytes of "Cc" 

Alphanumeric comment as_ supplied by Field. | | 

the user 
DUMP TABLE ENTRY 
Fr Fe a a eee ge ee en ee 
| T | ID {| LN | tT | P | A | F | 
Ma ca es a ee ete i Reena J 
T (1 byte) Type Entry field. Contents of this field for 

1E for DUMP TABLE each table type is as follows: 

DCB Normal "A" field containing 

ID (1 byte) Identification the DCB address 

The number assigned to this macro- DEB Normal “A"“ field containing 


instruction at expansion time 


LN (1 byte) Length | 
Length of this entry in bytes 


TT (1 byte) Table Type 
This byte specifies the type of table 
to be dumped as per the following: 


O04 = DCB (Data Control Block) 
08 = DEB (Data Extent Block) 
OC = TCB (Task Control Block) 


A (0-4 bytes) Name Address Field 
This field varies depending on the 
table type contained in the 2TT* 
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the DCB address 
TCB This field is omitted for TCB 


P (1 byte) Output Selection 


Specification 


Code 


F (1 byte) Flags 
Bit 0 - "P" Field Flag 
1 = Present 
0 = Not present 
Bits 1-6 - Not Used 
Bit 7 - "A" Field Flag 
1 = Present 
0 = Not present 


fe 


TRACE REFER ENTRY 


ee ee ee ee ee en ea a 
| T | ID{| IN| AL | A2 | P | Ss | FO | L | COM | DS | Ff 
be Be ee a ei bo ee es a ee ee 
T (1 byte) Type Entry DS (5-12 bytes) Dummy Section Name 

22 for TRACE REFER This field consists of 5-12 bytes of 


data as follows: | | 
Byte 1 - Length (1-8) of the symbolic 


ID (1 byte) Identification dummy section name 
The number assigned to this macro- Byte 2 - Repeat Count (1-255) 
instruction at expansion time Bytes 3,4 - Base/displacement address 


of dummy section : 
Bytes 5-12 - Symbolic name of dummy 
LN (1 byte) Length section 
Length of this entry in bytes 


F (1 byte) Flags 


A1,A2 Bit 0 - "P" Field Flag 
These fields contain the from and to 1 = Present 
addresses. 0 = Not present 


Bit 1 - "S" Field Flag 
| Present 
P,S,FO,L (S,L=2 bytes, P,FO=1 byte each) Not present 
These fields specify an out put Bit 2 - "FO" Field Flag 


OF 
Hoi 


selection code for output generated by 1 = Present 

this statement and overriders for 0 = Not present 
attributes contained in the symbol Bit 3 - "L" Field Flag 
table. If no symbol table exists, 1 = Present 

these are attribute specifications. 0 = Not present 


Bit 4 - "COM" Field Flag 


1 = Present 
COM (2-121 bytes) Comment Field 0’ = Not present 
Byte 1 - Length of Comment Bit 5 - "DS" Field Flag 
Bytes 2-121 - Alphanumeric Comment 1 = Present. 
0 = Not present 


Bits 6-7 - Not Used 
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TRACE CALL ENTRY 


SS ee en ee a en 


|r | ID] IN| Atl | A2 | P 


COM r DS | F | 


Os SS a a a es ea ee et et a ee Se te eer ere eta at aera nen ae epee asae aie aerial 


T (1 byte) Type Entry 
26 for TRACE CALL 


ID (1 byte) Identification 
The number assigned to this macro- 
instruction at expansion time 


LN (1 byte) Length 
Length of this entry in bytes 


A1,A2 
These fields contain the from and to 
addresses. 

P (1 byte) Output Selection Code 
Specification 


COM (2-121 bytes) Comment 
Byte 1 - Length of Comment 
Bytes 2-121 - Alphanumeric Comment 


DS (5-12 bytes) Dummy Section Name 


TRACE FLOW ENTRY 


ONG T 
[vr | ID] IN] at: | a2 | Pp 


This field consists of 5-12 

data as follows: 

Byte 1 - Length (1-8) of the symbolic 
dummy section name 

Byte 2 - Repeat Count (1-255) 

Bytes 3,4 - Base/displacement address 
of dummy section 

Bytes 5-12 - Symbolic name of dummy 
section | | 


bytes of 


F (1 byte) Flags 
Bit 0 - “P" Field Flag 
1 = Present 
0 = Not present 
Bits 1,2,3 - Not Used 
Bit 4 - “COM" Field Flag 
1 Present 
0 Not present 
Bit 5 - DS Field Flag 
1 = Present 
0 Not present 
Bit 6,7 - Not Used 


T (1 byte) Type Entry 
2A for TRACE FLOW 


ID (1 byte) Identification 
The number assigned to this 
instruction at expansion time 


macCcro~ 


LN (1 byte) Length 
Length of this entry in bytes 


A1-A2 
These fields contain the from and to 
addresses. 

P (1 byte) Output Selection Code 
Specification | 


COM (2-121 bytes) Comment 
Byte 1 - Length of Comment 
Bytes 2-121 - Symbolic Comment 
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DS (5-12 bytes) Dummy Section Name 

This field consists of 5-12 bytes of 

data as follows: 

Byte 1 - Length (1-8) of the 
dummy section name 

Byte 2 - Repeat Count (1-255) 

Bytes 3,4 - Base/displacement address 
of dummy section 

Bytes 5-12 - Symbolic name 
section 


symbolic 


of dummy 


F (1 byte) Flags 
Bit 0 - "P" Field Flag 
1 Present 
0 Not present 
Bits 1,2,3 - Not Used 
Bit 4 - "COM" Field Flag 
1 Present 
0 Not present 
Bit 5 - DS Field Flag 
Present 
Not present 
Bits 6,7 - Not Used 


Qe 
nol 


oo 


Be 


TRACE STOP ENTRY 


Gras eS aR ae ae ee PUR ae a Ne ed 


l T ID l LN | TAL TA2 {| An ] P | F l 
Ba a es ria ee or a oe ee ee ee en ees ee eae eee eek ee en es ease len ee Jj 
T (1 byte) Type Entry If any “TA” fields are present, they 


2E for TRACE STOP 


ID (1 byte) Identification 
The number assigned to this macro- 
instruction at expansion time | 


LN (1 byte) Length 
Length of this entry in bytes 


TA1,TAn (3 bytes each) 


will contain addresses of specific 
macros whose action is to be stopped 
and only those listed will be stopped. 
Code 


P (1 Byte) Output Selection 


Specification 


F (1 Byte) Flags | 
Bit 0 - "P" Field Flag 
1 = Present 
0 = Not present 


If no "TA" fields are present; all Bits 1-7 - Count of "TA" fields in 
active trace macros will be stopped. this entry : 
TEST AT ENTRY 
Ia an Ries era Gea Tee ea aaa oe tae les ean ee aia (aaa ao eRe (ee aaa ae mareaL en mea eae 
{| T | ID | LIN | P | LOC1 | LOC 2 l LOC3 | LOCn | F | 
a ND a ee Yap pmneoe AL Sir ePae ote tea Mee Boel ee Peis J 


T (1 byte) Type Entry 
02 for TEST AT 


ID (1 byte) Identification 


The number assigned to this macro- 
instruction at expansion time > 

LN (1 byte) Length 
Length of this entry in bytes 

P (1 byte) Output Selection Code 
Specification ; 
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LOC1-LOCn (3 bytes each) AT Location 
Each of these fields is a 24 bit 
aksolute address at which the user has 
specified some TESTRAN action. 


F (1 byte) Flags 
Bit 0 - "P" Field Flag 
1 Present 
| 0 = Not present 
Bits 1-7 - Count of "A" field present 
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TEST OPEN ENTRY 


SE Ne er eye Oe Re ee et rer i Pere gn en ee ae 
[T |ID|LN| EP | ID iP | MP | ME | TLi | TL2 Tin | F | 
ON a a te year epnnner i Geseenareectes Seal y Wemeeree 
T (1 byte) Type Entry TL1i-TLn (4 bytes each) Table Locations 

OA for TEST OPEN Each of these fields contain the 


address of a secondary TEST OPEN macro 
to be loaded with this TEST OPEN 
ID (1 byte) Identification 
For the TEST OPEN entry, the number of 
the SVC assigned to the TESTRAN open F (2 bytes) Flags 


routine (49) Bit 0 - “EP" Field Flag 
| 1 = Present 
0 = Not present 
LN (1 byte) Length Bit 1 - Not used 
Length of this entry in bytes Bit 2 - "ID" Field Flag 
1 = Present 
0 = Not present 
EP (3 bytes) Entry Point Bit 3 - "P" Field Flag 
This field contains the address to 1 = Present 
which TESTRAN is to give control after 0 = Not present 
executing the TEST OPEN macro. Bit 4 - "ML" Field Flag 
1 = Present 
0 = Not present 
ID (8 bytes) Identification Bit 5 - “ME" Field Flag 
This field contains an alphanumeric 1 = Present 
name, supplied by the user, to be used 0 = Not present 
by TESTRAN to identify output of this Bit 6 - Not used 
table. Bit 7 - Transient or Non Transient 
7 mode flag as follows: 
P (1 byte) Output Selection Code Specifi- 1 = LINK 
cation | 0’ = LOAD 
This is a flag to inform the 
MP (2 bytes) Maximum number of Output pages TESTRAN Router whether to link to 
the user desires TESTRAN to generate or load required routines. 
(1- 65535) | Bits 8-15 - TL count 
These bits contain a count of the 
ME (2 bytes) Maximum number of macros to be "TL" fields present in this TEST 
executed by the TESTRAN Interpreter OPEN macro. 


TEST CLOSE ENTRY 


Bo ee ee ee Sr eg ge Ce ey 1 
| Ay | ID l LN | 
ne pee anne ae eee ae eet ie ie ee ee J 
T (1 byte) Type Entry LN (1 byte) Length 
32 for TEST CLOSE Length of this entry in bytes. 


ID (1 byte) Identification 


The number assigned to this macro- Note: This macro does not have a variable 
instruction at expansion time field. : 
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a 


TEST DEFINE COUNTER ENTRY 


a Ng ee ee rn ae Ae ie eae re ee ee te ee ee el 
| T ID | LN | oT. | cT2 | cT3 | cTn l 
ieee ae ae eae 5 (Cena enn ae Peele ls te ete oe ed 
T (1 byte) Type Entry LN (1 byte) Length 
42 for TEST DEFINE COUNTER Length of this entry in bytes 
| CT1-cTn (1 byte each) 
ID (1 BYTE) Identification | Each of these one byte fields is a 
The number assigned to this macro- counter to be used by TESTRAN TEST ON 
instruction at expansion time macros. Their initial value is zero. 


TEST DEFINE FLAG ENTRY 


(Se a ee ee ES SS ae eee 
| T | © ID LN | FG1 | FG2 | FG3 | FGn | 
Ue a I a re Dl ee ee asd, 
T (1 byte) Type Entry IN (1 byte) Length 
46 for TEST DEFINE FLAG | Length of this entry in bytes 
ID (1 byte) Identification FG1 - FGn (1 byte each) | 
The number assigned to this macro- Each of these are one byte fields 
instruction at expansion time which the user may use aS a Switch. 
Each flag has an initial value of zero 
(off). 
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TEST ON ENTRY 


TT T T 
T | ID | IN | TA l Al 


BR rt a er en ee en Bt ee ee a a 


T (1 byte) Type Entry 


ID 


LN 


TA 


Al 
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56 for TEST ON 


(1 byte) Identification 
The number assigned to this macro- 
instruction at expansion time 


(1 byte) Length 
Length of this entry in bytes 


(3 bytes) TESTRAN Address 
This field contains the 24 bit address 
of the next TESTRAN macro to be 
interpreted if a true conclusion is 
reached for this macro. 


Counter Field 
This "A™ field will contain either a 
one byte literal (initialized at zero) 
to be used aS a counter or the 4 byte 
address of a counter defined with a 
test define counter macro. 


These 3 "A" fields will each contain 
one of the items listed below. 


1. 


Literal: A literal value to be 
used in determining a true or 
false conclusion for this macro. 


Address: The address of a four 
byte variable, in the object pro- 
gram to be used in determining a 
true or false conclusion for this 
macro. 


Register Number: A general reg- 
ister whose contents are to be 


used for determining a true or 
false conclusion. 


A2 - Low Limit 
A3 - High Limit 
AW - Interval 


foe 


TEST WHEN ENTRY 


Ip | IN | TA | 


a a ce se ne A coe ee ee eee en ee Li LL —— —— — — — ——  — — heen een cen dhe 


T (1 byte) Type Entry 
5A for TEST WHEN 


ID (1 byte) Identification 
The number assigned to this macro- 
instruction at expansion time 

LN (1 byte) Length 


Length of this entry in bytes 


TA (3 bytes) TESTRAN Address 
This field contains the 
of the next TESTRAN 
interpreted if a true 
reached for this macro. 


24 bit address 
Macro to be 
conclusion is 


OP (1 byte) Operator 


This field contains an operator speci- 


fying the relation to be checked 
between A1 and A2 as follows: 
00 = Equal 
04 = Not Equal 
08 = Less Than 
OC = Greater Than 
10 = Less than or equal to 
14 = Greater than or equal to 
18 = AND+ 
1c = ORt 
20 = Independent Field (A2 Not 
Present)+ 
1No FO or L fields will exist. 
SET COUNTER ENTRY 
(SSS oo ee ee eee 
| T | ID | LN | 
See ee eee Boe ee eee 
T (1 byte) Type Entry 
4A for SET COUNTER 
ID (1 byte) Identification 
The number assigned to this macro- 


instruction at expansion time 


LN (1 byte) Length 
Length of this entry in bytes 


‘TA (3 bytes) TIA Table Address 
This field contains the address of the 
counter to be set. 
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Paes Oe NT PSG ® BOON EG gee ie ee Ne eee ne ore 
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OP {| FO | 


anes =p ante aa ante 


FO (1 byte) Data Format 


E (1 byte) Extent 
This field specifies the length of the 
data items to be compared. 


A1,A2 Address Fields | 
These fields will each contain one 
the following. 


of 


1. Literal: A literal to be used as 
one item in the compare. 

2- Address: The address of a varia- 
ble or constant to be used in the 
compare. 

3. Register Number: The number of a 
general or floating point reg- 
ister whose contents are to be 
used in the compare. 

pS iene eh Eh 1 
TA | A2 | 
ph A ee Rae ee ee ee te Nt ant ee J 
A2 3 
This field will contain one of the 
three items listed below. 

Vy Literal: The counter is to be set 
to the value of this literal. 

2. Register Number: The counter is 
to be set to the value contained 
in this General Register. 

3. Address: The counter is to be set 
to the value contained in the 
full word located at this 
address. 
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SET FLAG ENTRY 


Gn a eee ee Te a pe Te ee ewe ee NT eee a Oy Og ee eR Oe See 

| T | ID | LN | TA | A2 

a eI gh sea fs ee aoe i a a j 
T (1 byte) Type Entry ~A2 | 

WE for SET FLAG : This “A™ field will contain either an 

integer (must be 0 or 1) or the 

ID (1 byte) Identification | address of another TESTRAN flag. If 

The. number assigned to this macro- - the field contains an integer, the 

instruction at expansion time flag will be set to that value. If 

the field contains another flag 

LN (1 byte) Length address, the flag specified in the 

Length of this entry in bytes "TA' field will be set to the value of 


the flag at that address. 
TA (3 bytes) 


This field will contain the address of 
the TESTRAN flag to be set. This flag 
must be defined elsewhere with a TEST 
DEFINE FLAG macro. 


SET VARIABLE ENTRY 


Ci pee ne er ree a ag st a a eg fing eee Ted Geen an Fe oe ee ee 
i T | ID | LN [ Al | A2 { L | 
De a a NN a a a ot ete) 
T (1 byte) Type Entry _ A1,A2 Address Fields 
52 for SET VARIABLE These fields may contain either of the 
two items listed below. 
ID (1 byte) Identification 1. Address: An object program 
The number assigned to this macro- address. 


instruction at expansion time 


2. Register Number: A general or 

floating point register number. 

LN (1 byte) Length In addition, the A2 field may 
Length of this entry in bytes contain a literal. 


L (1 byte) Length of data fields specified 


GO IN ENTRY 


(oe oe Sees ee pa ae a a Mg ae wer ee ENS Fp RT ae ESE Ne ee ee 1 
| T | ID | LN TA | 
eae es BN aes Se a ot bce Leen nae Aenea BU a i ee ee 3 
T (1 byte) Type Entry IN (1 Lyte) Length 
36 for GO IN Length of this entry in bytes 
TA (3 bytes) TIA Table Address 
ID (1 byte) Identification This field contains the address of the 
The number asSigned to this macro- TIA Table entry to be interpreted 
instruction at expansion time next. | 
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GO OUT ENTRY 


T (1 byte) Type Entry 
3A for GO OUT 


IN (1 byte) Length 
Length of this entry in bytes 


ID (1 byte) Identification 


The number assigned to this macro- Note: This macro does not have a variable 
instruction at expansion time field. 
GO BACK ENTRY 
Co ee ee ap oe Mee ea ge ee eg Oe ie Seta ee ee ee 1 
| T | ID | LN | Al | 
ana eee eae ee een ee eee pee le a ee as aC ra Cae ae eta ge ee le eR a reel ete ee ee ee Oe 4 
T (1 byte) Type Entry Ail Address Field 
3E for GO BACK This field when present will contain 
an object program address to which the 
ID (1 byte) Identification | programmer wants TESTRAN to return 
The number assigned to this macro- control. 
instruction at expansion time 
LN (1 byte) Length 
The length of this entry in bytes 
GO TO ENTRY 
fae ee Neg ees ee oe age es eee Red ag ep ee oe ee 1 
| T | ID | LN | TA | 
ee a eee BS ete Sg a es ei 4 


T (1 byte) Type Entry 
5E for GO TO 


ID (1 byte) Identification 
The 
instruction at expansion time 


Appendix As: 


number assigned to this macro- 


IN (1 byte) Length 


Length of this entry in bytes 


TA (3 bytes) TIA Table Address 
This field contains the address of the 


TIA Table entry 
next. 


Test Interpreter Action (TIA) Table Entry Types 


to be interpreted 


95 


APPENDIX B: TESTRAN INTERPRETER TABLES 


This appendix contains diagrams and byte-by-byte descriptions of the tables generated 
and used by the TESTRAN interpreter. 


CONTROL CORE 560 BYTES 


T j Bi T T 
Oo; N | NEXT | REF TAB | FLAG TAB | CTR TAB | 


a a a 
16] F {| RF {| AP | TR CORE | OP | (NOT USED) | SEG TAB l 
-—--——~-1~-—~—-—— —-~~—~—-—4--~—-—1-~ —---——--—- - -- ~~ - 4 ~~~ Lf as Seas oc a aaa a ee ear 
32| CUR TABLE | MAX LINES l CRB | TCB | HQOUTPUT | 
Sp ease i os ae ee eat ——-—-—-—--—-—--—-—-——-—- ——-—-—-- | -- --— -- 7 -~ -- - —-- - - 1-1 


48 | RETADR | OUTAMT | ME | 


| 
| | PROLOGUE BUFFER | 

| 142 | 
112| .-------- 4 
128 }---------------------------—--------------- ------------------------------—- j 
| 

| 

| 

| 


| 
144] DATA BUFFER 
| 
224 | 246 255 


| 7 T 4 
240 | | SUBRT | | DUM | 


eae eis ene an LS +--+ + - - 1 | 


256| REFENT | | l 


Pees a a aE TE | 


272 | TEMPORARY STORAGE 1 300 | 


| r 
288] | 312 | HB TEMP | 


|~-----------~--------------------—------y-—-------------------------—-4------------4 


304 | 328 l TEMPORARY 


eee erase —_-—-----+--- -—---- -- Boe See eee ees eee eee eee 
-320| STORAGE 2| (NOT USED) | 
}——-————————— ii a le ih il ie rt es aaa 


336] 
| (328 TO 423 INCL.) OUTPUT DCB 
| 424 


| : 
416] | | OUTPUT DECB 


on nn nr on hen ey ef 


432] (424 TO 443 INCL.) | | 


}---—- ----—-—-—---- --—---~---—-—--—- +--+ ——- — -— - - ——- - + J 


| 

444 l 

(444-515 INCL.) : l 
BSAM SAVE AREA { 

| 


| 
| 
| 516 r 

5 28 | (516 TO 559 INCL.) HQSAVE AREA | 
| 

d 


| ec eee ee cee eee amen ae emne nD GED ane =D cap aap GED et Ge ee ae Se Se ee ee ae 6 eee SE 6 68 re ae 6 ae SP eae ae Se ee 6 ee CO ee GF Ow ow Oe oe Oe Oe 6 SE SC © OF a 6 oe ee GD em ea OD ee ow DO ee OP 2 oD OP enews eo 
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N (1 Byte) 
Last number assigned to a TIA table 


NEXT (3 Bytes) 


Address of next core area 


REF TAB (4 Bytes) 
Address of first reference 
the reference table chain 


table in 


FLAG TAB (4 Bytes) 
Address of first flag table in the 
flag table chain 


CTR TAB (4 Bytes) 
Address of first counter table in the 
counter table chain 


F (2 Bytes) Flags 
Bit O = Removed instruction execution 
control 
0 = Execute removed instruction 
1 = Delete execution of removed 
instruction 


Bit 1 - Overlay flag 
Program contains overlay 
No overlay 
«32 = Table type 
11 = Control 
Bit 4 Link/load option 
1 Link mode 
0 Load mode 
Bit 5 - Dump SEGTAB flag 
1 SEGTAB must be dumped 
0 No SEGTAB to be dumped 
6 - Protection 
1 = Protection 
0 = No protection 
Bit 7 - Floating point register flag 
1 = Hardware contains floating- 
point 
0 = No floating-point hardware 
Bit 8 -— No start trace flag 
1 = Suppress trace start 
0 = Permit trace start 
Bit 9 - Not used 
Bit 10 - SAVE routine flag 
1 = SAVE routine has operated 
0 = SAVE routine has not operated 
Bit 11 - Trace mode 
1 = Trace mode 
0 = Non trace mode > 
Bit 12 - Branch type instruction (used 
by GO BACK) 
1 = Instruction being executed is a 
branch 
0 = Instruction being executed is 
| not a branch 
Bit 13 - Type Tasking 
1 = Variable number of tasks 
0 = Fixed number of tasks 
Bit 14 - Not used 
Bit 15 - Table opened 
1 = A TIA has been opened 
0 = No TIA opened 


Ba 
0 
Ss 


N Il il 


Bit 
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RF (2 Bytes) Return flags | 
from all routines except 


0000 Return 
TRACE, GO BACK, CLOSE 
0008 Return from GO BACK, CLOSE 
QO0OO0OE Return for TRACE, TESTRAN SVC 
0014 Return from TRACE for TTOPEN or 


overlay SVC 


AP (1 Byte) AT Priority 
Priority from the last “TEST AT" macro 


TR CORE (3 Bytes) _ 
Address of working storage gotten for 
trace 


OP (1 Byte) OPEN Priority 
Priority from the "TEST OPEN" macro 


NOT USED (3 Bytes) 


SEG TAB (4 Bytes) Segment table address 


CUR TABLE (4 Bytes) Current tab) address 
Address of table core ”“ r the TIA 
table currently being ir -rpreted 


MAX LINES (4 Bytes) 
Maximum lines’ of output to be 
generated for the c <rent task 
CRB (4 Bytes) 
Callers R.B. address 
TCB (1 byte) 
Size of TCB in bytes 


HQOUTPUT (3 Bytes) 
Address of HQOUTPUT routine 


RETADR (4 Bytes) 
Address in users program control is to 
return to 


OUTAMT (4 Bytes) 
Number of lines of 
generated for this task 


output already 


ME (2 Bytes) 


Maximum execution count of TESTRAN 
Macros to be interpreted during this 
task 


PROLOGUE BUFFER (84 Bytes) 
DATA BUFFER (104 Bytes) 


SUBRT (9 Bytes) 
Subroutine table 


DUM (1 Byte) 
Dummy GOBACK macro 


REFENT (4 Bytes) 
Address of the current reference table 
entry 


TEMPORARY STORAGE 1 (40 Bytes) 
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HBTEMP (12 Bytes) 
Temporary storage reserved for the 
HBADDRSR routine 

TEMPORARY STORAGE 2 (12 Bytes) 

NOT USED (4 Bytes) 


OUTPUT DCB (96 Bytes) 
DCB to be used for intermediate output 
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OUTPUT DECB (20 Bytes). 
DECB used for writing on the inter- 
mediate device 


BSAM SAVE AREA (72 Bytes) . 
Register save area for the BSAM rou- 
tines 


HQOSAVE AREA (44 Bytes) 
Save area used by HQOUTPUT subroutine 


TRACE CORE 272 BYTES 


Base ot eee Re GV TS ce eS 
Sg en eT ee ee ee eT 

+ 0| | 
| 
16| | 
| | 
32| | 
| | 

48 | TRACE TABLE l 
| | 

64 | | 
| | 

80 | | 
| | 
96| +120 123 124 | 
| (i pee aan. aera Sa a a 4 
112] | ZERO | oL | EADR l 
cn a a aa aa poe sSss52s=45=>= Se a er ear Ha 
128| UPSW l WPSW l 
SS Sg ee ea a ae 
144] EF | CONTROL | SF | COPY | TF | BA l 
Si a aM a ee [eee ae eee ne tls aoe ae ee a ey pera Wea Paes se oe ee ee J 
| 145 148 149 155 156 { 
160| 
| | 
176| 
| , | 
192| TEMPORARY STORAGE 1 l 
| | | 
208] 
| | 
226 | 244 248 249 250 l 
re er ee ee ee ee ee ee 
240} RRB | TEMPORARY STORAGE 2 | C | LE | SVC | ; | 
 Seeeipnne nareen ocean sarenener es Me eee ee ees ieee eae jr ianaeene i Seance area eee J | 
256 | TEMPORARY STORAGE 3 | 
hi assed ee ye eh ea eee ere eee ee ee eee ee 
TRACE TABLE (120 BYTES) FF = Instruction being traced is an 


, | execute 

This field contains a list of all cur- 

rently active traces. CONTROL (3 Byte) Control address 
ZERO (3 Bytes) 

Work constant of zero 


SF (1 Byte) Stop flags 
Bits 0-3 Not used | | 
Stop trace due to SVC, bad 


Bit 4 12: 
OL (1 Byte) Output length EX, PRIV. instruction: or - 
Storage for length of output data bad store address 
record Bit 5 1 = Stop trace due to program 
check | 
EADR (4 Bytes) Execute address Bit 6 1 = Stop trace due to overlay 
Addréss of last execute instruction Bit 7 1 = Stop trace due to TRACE 
traced STOP macro 
UPSW (8 Bytes) User PSW COPY (6 Bytes) Instruction copy 
Storage for the users PSW Copy of the instruction presently 
being interpreted 
WPSW (8 Bytes) Work PSW | 


PSW build area used during enable and 
disable functions 


EF (1 Byte) Execute Flag 
00 = Instruction being traced not an 
execute | 


TF (1 Byte) Flags 
Bits 0,1 Not used 
Bit 2 Interrupt routine flag 


1 = User-supplied interrupt routine 
being traced 
0 = Not in interrupt routine 
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Bit 3 SVC in switch 
1 TESTRAN SVC must be reinserted 
0 TESTRAN SVC not to be reinsert- 
ed 
Bit 4 Reference out switch 
1 = The before portion of reference 
trace output has been generated 
for the instruction presently 
being interpreted 
0 = No output generated 
Bit 5 Reference trace switch 
1 = Reference type trace active | 
0 = No reference type trace active 
Bit 6 Call trace switch 
Call type trace active 
No call type trace active 
Bit 7 Flow trace switch 
Flow type trace active 
No flow type trace active 


or 
Hot 


oF 


BA (4 Bytes) Branch address 
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Effective address of branch instruc- 
tion being interpreted 


Temporary storage 1 (80 Bytes) 


RRB (4 Bytes) Router RB 
Contains the address 
routers routine block 


of the 


Temporary storage 2 (4 Bytes) 


TESTRAN 


Cc (1 Byte) Count of trace table entries 


LE (1 Byte) Last trace table entry 


Svc (2 Bytes) Dummy SVC 


Dummy SVC used during execution of a 


user SVC 


Temporary storage 3 (20 Bytes) 


TRACE TABLE (120 BYTES MAXIMUM) 


Kee e See oe ee 1 BYTES 225-2335 S3S  s 
Sar am raed yaa nae i 7 aaa aaa Mo ee a a a 1 
1 | v P ™ | MN | FROM | TO | 
| }-------- }-------- +-------- oman nnn {—~-------------------— }------------------------ { 
| | | | | | | | 
| | | | | | | | 
| | | | | | | 
oO | | | | | | | 
eat | | | | | | 
10 | | | | | | 
| | | | | | 
E | | | | | 
N | | | | | | 
T | | | | | | 
R | | | | | | | 
I | | | | | | | 
E | | | | ( | 
Ss | | | | | : At | 
| | | | | | 
| | | | | | | | 
| | | | | | | 
| | | | | | | 
| | | | | | | | 
a ra a ee 
T <1 Byte) Type of entry MN (1 Byte) Macro number 
00 = End of table The macro number of the macro which 
22 = Call type trace entry | generated this entry 
26 = Reference type trace entry 


2A Flow type trace entry 
FROM (4 Bytes) 
P (1 Byte) Output Selection Code Start address of the area being traced 
Output selection code for output gen- 
erated by this entry 
TO (4 Bytes) 
TN (1 Byte) Table number 
Number of the TIA table containing End address of the area being traced 
this trace macro 
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DCB/REL CORE 


qk 8 BYTES +-—----------—---—---—----~—--———-—-—-----—--— > 
SS SS SS SS Se a rr SSS = 5 
+ 0] , NEXT | TTR 
[-----------~- -——-- ~~ ----- = +8 == = 
+ 8 M B B Cc Cc H H R | 
mn tn gy ce ec ecm 
+16] F ; | LASZ | | | 
| -— -—-—-—-___~ -_____t______ | 
+24 | DCB | 
TT (oD 
+32| i LA1 [ 
(SSS ee | 
| | 
| | 
| 
| | 
| | 
[. | 
| | 
| p aR aeene sere na ee eee 
| | LAn | 
|-~---—---------------------------------—— bh nn { 
| DEB | 
AL ee re ee ee eR eNO SNE ae SERN ES SSN tr aR rey Mee EMS AE PTS aA EE AREER RE OE 4 
NEXT (4 Bytes) LASZ (2 Bytes) 
Pointer to the next DCB/REL. Zero in This field contains a count of the 
this field designates the end of the bytes occupied by ‘LA‘ entries. 
chain. 
TTR (4 Bytes) DCB (16 Bytes) 
Relative disk address of the symbols, This field contains a copy of the DCB 
ESD and composite ESD used by program fetch to load the 
| program. 
MBBCCHHR (8 Bytes) 
Absolute disk address of the symbols, 
ESD and composite ESD LA1-LAn (4 Bytes each) 
Loaded address of a control section in 
F (2 Bytes) Flags the load module 
Bits 0,1 Not used 
Bits 2,3 Table type DEB (variable size) 
10 = DCB/REL Copy of the DEB used by program fetch 


Bits 4-15 Not used in loading the program 
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yoo 


REFERENCE TABLE 


Ce eee ae eee a ee C°(BYTES Step se feo oe ee ee ee > 
aa aa a 5 aaa mac: De ee a ne ee ee ee 1 
| NEXT F | CT | 
ee ee eee | IRL SECC SSS e a saa aaa { 
| OA1 { RM1 | TA1 | 
|------------------------------- +------------------- }-------------------------------- { 
| OA2 | RM2 | TA2 | 
| | | [ 
Serer ea sae a Sa ee eee { 
| | | | 
| | | | 
| | | 
| | | | 
| | | | 
| | | 
| | 
pean nn nnn nnn a fone nn nnn nn nn { 
[ | | | 
}------------------------------- faa naa f-------------------------------- { 
| OAn | RMn | TAn | 
a rs th ee 5 RE ee ty a PLT RETR ay a eh a il ee J 
Each TESTRAN action table generates a OA1-OAn (3 Bytes each) Object program 
reference table. Each SVC inserted, by address 
TESTRAN, in the problem program generates Address in the object program where a 


an entry in the reference table. 


NEXT (4 Bytes) 
Address of the next reference table 


F (1 Byte) Active/Inactive flag 
00 Table active 
FF Table inactive 


CT (3 Bytes) 
Count of 


entries in this reference 
table : 
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TESTRAN SVC has been inserted 


RM1-RMn (2 Bytes each) Removed instruction 
The two bytes of the object program 
displaced by the TESTRAN SVC 


TA1-TAn (3 Bytes each) TIA address 
Address in the TESTRAN action table, 
of the 'TEST AT' macro which caused 
the SVC to be inserted 
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FLAG TABLE 


€--+—-+ +--+ 4 BYTES —~---————~~—-~~-~~~~~--+~~-~~~-—~_~~—_-+-___ > 
ar aaa Set ae ea A A Se Sour Fee eer ee eee mg ore ee eg rn er 1 
; A | CT NEXT TAB | 
}----1-------~-—-~- fanaa a nn nnn nnn nnn nnn nnn nnn nnn nnn 1 
| FG1 | ADR1 ; 
|}---------~~------~--— 4------------------------------—------—----- --------—---------- { 
| FG2 ; ADR2 { 
paSSe lea SSeS (oS SS aa ee en ee ee | 
| | 
| | 
| | | 
| | | 
| | | 
| | 
prmne mn nnn |}---------------------------—----------------------------—------ { 
| FGn | ADRn | 
YE Ae Ee setae aNd oar ey? a a ae a eee eee 4 
A (1 Bit) NEXT TAB (3 Bytes) 
This bit specifies the table is active This field contains the address of the 
or inactive next flag table 
0 = Active 
1 = Inactive FG1-FGn (1 Byte each) 
The actual flag to be set and cleared 
by TESTRAN 


CT (7 Bits) | 
Count of the number of entries in ADR1-ADRn (3 Bytes each) 
this table TIA table address of the flag 


104 


COUNTER TABLE 


<--~--~-~---+-- ---+--+-----~-----—------- 8 BYTES --—-----------~------------—----------> 
CO a Fe eee We ee eee ge ee ee OR ee ce ee eee Pe eee We ee Oe et ee Pag ee ge a gt Pete, oie ce a es ee q 
| A | COUNT | NEXT TAB | 
}-------—--—-----—-1---—~-—-—~-~~~—-—~—~~—~-—-—---+--—-—-—- 4 -- -- - - -- - — - - +--+ +--+ | 
| ADR1 | CTR1 l 
pass Se re ee Saar 
fo ADR2 | CTR2 | 
aa aaa a foe ee eer eee ena { 
| | | 
| | | 
| | | 
| | | 
| | | 
| | 
| | 
| | | 
| | | 
eo a ee ee ae ee ee eee rat 
| ADRn | CTRn | 


Lo TRY alent ipa: KE AR AN EE OS UY OED CE CRI PEETTD CEURUR SR Gave SS EE GY A aoe GED Ee OU ae Aide Be ee ES CAE SE CE AS EE SE ED ee AEE a Ge a OS ee GE EE ee ae ee ee ES ee ee a ee Si se 


A (1 byte) Active byte : ADR1 - ADRn (4 Bytes each) 
Zero-table is active These fields will contain the TESTRAN 


Not zero-table is inactive TIA table address of where the counter 
: : was defined. 
COUNT (3 Bytes) 

Count of the number of entries in this 


table CTR1 - CTRn (4 Bytes each) 
These fields will contain the actual 
NEXT TAB (4 Bytes) counters used by the TESTRAN routines. 


This field contains the address of the 
next counter table in this chain. 
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TABLE CORE 


<~~---~--+-----~----~-~~~----~-~------ 16 BYTES ~-—------~—----~--------------------- > 
aoe ee es ee Ae ee Cob a ee ae Sg as asa AT a aD a a a 1 
NEXT } N | TIA OPBY | cs | 
ae eins : as Sa a a a | 
l F | LN | | 
---—-- is sce faerie all aes sere ewe cai [ 
l REFERENCE TABLE | 
| 7 | 
ee ee ee ne er er a ee oe 
| : | | | 
| FLAG TABLE l 
| | 
| COUNTER TABLE 
| 
oti et a ee ee er es ee ae ee ee eee ad 


NEXT (4 Bytes) Next pointer 
Pointer to the next table 
DCB/REL core. zero in this 
indicates the end of the chain. 


core or 
field 


N (1 Byte) TIA number 
Number assigned the TIA table asso- 
Ciated with this table core 


TIA (3 bytes) TIA address 
Address of the TIA table for which 
this table core was generated 


OPBY (4 Bytes) Open address 
Address of the TEST OPEN macro which 
opened the TIA associated with this 
table core 


CS (4 Bytes) Checksum 
Checksum word for the TIA associated 
with this table core 


F (2 Bytes) Flags 


Bit 0 Active/Inactive Flag 
0 = Table active 
1 = Table inactive 
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Bit 1 Not used 
Bits 2,3 Table type 

00 = Table core 
Bits 4-6 Not used 
Bit 7 Just opened flag 
0 = Just OPENed 
1 = Not just OPENed 
Bits 8-15 Not used 


LN (2 Bytes) Length | 
Length of the TIA table for which this 
tabie core was generated 


REFERENCE TABLE 
Reference table 
TIA table 


associated with the 


FLAG TABLE 
Flag table 
table 


associated with the TIA 


COUNTER TABLE 
Counter table associated with the TIA 
table 


SUBROUTINE TABLE 


a asa neal i ee Se S BVUES eee ee ee ee > 
a a er oe Oe ge ee Ce eg Bee OE ear Ae ge OG eg Nine gee Eee Gee Eg Nw Ee Fe gent ae MID Se Me ny 1 
| | 
aa ac om a mm a a a 4 
| | 
paee SSS a re en ee ere ees { 
| | 
Ma a a a cc cc ta cn es ce i seen satu So sey sm mci Gi ell ai is as me ca saan sab ee ced aes sa sce Sess ‘secs Ca Mn Sa See Pes Va soem Sma ee ee se ae en piso eo ee soe se a ee J 


3 entries of 3 bytes each 


The GO IN routine fills the first vacant 
3 byte slot with a return address. If the 
table gets filled, (more than 3. entries) 
the first entry is pushed off the top and 
the whole table is moved up one entry with 
the new entry inserted at the bottom. 
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On returning, the addresses are used 
from bottom to top. As one is used for a 
return it is zeroed. 


This entry table is zeroed on each entry 
to the TESTRAN router. (A TESTRAN SVC 
caused by a TEST AT macro.) 
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APPENDIX C: TESTRAN EDITOR TABLES 


This appendix contains diagrams and byte-by-byte descriptions of the tables generated 
and used by the TESTRAN editor. | , 


TABLE DICTIONARY 


| REFERENCE TABLE 
| Start Address 


| 
+ 
| 
| 
f—=- = SASS ee Se 5 naa a { 
l ACTION TABLE LIST | 
| 
+ 
| 
| 


| Start Address 


} a a pa ae eae ec Se ie ee ee ee aia oe ee 
l DUMP CHANGE LIST 


| Start Address 


(4 bytes) (4 bytes) 


MAP ENTRY 


(Sorted by LA field) 


Ud 


Be ee ie a eR ee Se ee ae ee ee ee Wa ae pe NP ye ae Ne eet ee ee eee ie pete sare eae te =a ve a Ree 1 
| N | AA j s | LA i B | L { fi | c | L | 
boot eae eee bo 1 ee oo Loe Sect eee ae eee ee: a pas a eer es J 


N (1 byte) Input Sequence Number 0 = CSECT 
4 = Private Code 
AA (3 bytes) Assembled Address 5 = Common 
8 = DSECT 
S (1 byte) Segment Number 
LA (3 bytes) Loaded Address L (3 bytes) Length of CSECT in bytes 
B (1 byte) Status Byte T (8 bytes) CSECT Name 
Bit 0 Active Indicator | 
0 = CSECT Active C (1 byte) Assembly Number 


1 = CSECT Inactive 
Bits 4-7 Type 


i 


(3 bytes) I/O Key of Symbol Table 
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ACTION TABLE LIST 


Entry 

eo og ey ee eye ep ge ee 
| TIA | ID | IOKEY 

eee eee a eee eee a eee esa ees 


TIA (1 byte) Action Table Number 


ID (1 byte) Identification of last entry in 
Action Table 


IOKEY (3 bytes) I/O Key of Action Table 


DISP (2 bytes) Offset of Action Table from 
beginning of buffer 


LA (3 bytes) Loaded address of TIA Table at 
Interpreter Time 
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ACTION TABLE ENTRIES 


Ne ee a a eg ee et eg ean eg ed ey eg 
TEST |ID [LN | M[{ DCB | NAME | ML | ME | 
OPEN | f | | | | | 
Sas SSNS TENGE AGSTEE SRS MEGANE SEER SEONG GARCROROAGER NE SONLIG  Riar EEL TLLe NTL ROSCOE AERIAL (SERGE HESS 
DUMP {ID |IN| M|FO | S  |4L  |DSR] DSA | DSNM | VLN{ NM] 
para | 6th 6 Ud to | | 7 bE 
~-}---}---}---}---4-—-----} ---} --- }--—---}}- + -- —-------—-- =f ff 
DUMP |ID {IN| M{|FO{ S {UL [DSR] DSA |. DSNM {VLN|NM | 
CHANGE | | | | | | 6 | | | | | 
—-}---}---4---}---}------} ---} ~~ bf nn nnn nnn nnn nnn hn nd nnd 
DUMP |ID {LN | M|FO | S |{UL{| REGMSK | 
PANEL | tf ft | | | | | 
~—1———4——-4—-~44---4---- ---1---b_d 
DUMP |ID {LN | M {TT | 
TABLE | | | | ; 
—-t---}-—-}---}---1-------------------- ------—-—-—- 
DUMP JID {LN | M | Variable Field [ 
COMMENT | | | | | 
Sa ea ea 
TRACE |ID [LN | M |FO {| S  |L{DSR] DSA | DSNM | VLN| COM | 
REFER | | | | | f ft J | | | | 
~—-}---4---}—-~-4---4------_4--- 1-4 + by f+ 
TRACE |ID [LN | M |[DSR| DSA | DSNM | VIN | COM | 
CALL | | | | | | | | 
~-}---}---}---}~--}-------}-------------------------------- }--- f------------—--4 
TRACE {ID {LN | M [DSR{ DSA | DSNM | VLN | COM | 
FLOW | | | | | | | | 
se a A a er a ee eed 
ID (1 byte) Macro Identification Number S (2 bytes) Scale Modifier 
LN (1 byte) Length of entry in bytes L (2 byte) Length Modifier 
MQ byte) Mask, indicating presence of DSR (1 byte) Repeat Count 
Bit 0 FO or DCB 
Bit 1 S or ID 
Bit 2 Lor ML DSA (2 bytes) Dummy Section Address 
Bit 3 ne or ME | 
Bit 4 or COM 
Bit 5 REGMSK | DSNM (8 bytes) Dummy Section Name 
DCB (3 bytes) Address of DCB VLN (1 byte) Length of COM or N field 


NAME (8 bytes) Name of TESTRAN Control REGMSK (3 bytes) Register Mask 
Section Bits 0-15 General Registers 0-15 

Bit 16 Floating Point Register 

Bit 18 Floating Point Register 

ML (2 bytes) Maximum number of output lines Bit 20 Floating Point Register 
| Bit 22 Floating Point Register 


ONO 


ME (2 bytes) Maximum number of TESTRAN 
Statements to execute 
TT (1 byte) Table ID Dumped 
FO (1 byte) Format modifier 
00 Character 
01 Hexadecimal COM (Variable) Comment Over-rider 
O02 Fixed Point 
03 Floating Point 


04 Packed Decimal NM (Variable) Name Over-rider 
05 Zoned Decimal 
OA Binary 
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DUMP CHANGE LIST ENTRY 


Gr age eg es ie ee en ee AG go eee RMA ST a oe es ee oe a Te aye ee NE gy Oe Fe, eg oe Ee se Oe 


| TIA l M | 


TIA (1 byte) Action Table Number 
M (1 byte) Macro Identification Number 


IOKEY (3 bytes) I/O Key of Dump Change Table 


DUMP CHANGE TABLE ENTRY 


N (1 byte) Dump Change Table Entry Number 
LA (3 bytes) Loaded Address of Data 
L (2 bytes) Length of Data 


IOKEY (3 bytes) I/O Key of Dumped Data 
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IOKEY 


Testran Editor Tables 
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SYMBOL TABLE 


Se eee 
HEADING | A | IND| 
SS ay a a er ee pr ee re eee 
| LE | A {| OR | ww | SYM | M | os { 
a Be he ERE ee a ogc ee aA ee +~—-——--- ee ee Bee et Se J 
| 
VARIABLE }-—---—-----—--~—~----~--——+-+~+-—--+~+-~+~+~+----+---~- 7o-—---—-- J 
LENGTH | | 
ENTRIES }----—-------—------------—--—---------- 1------- 4 
| | 
}—--—-—--—-—- -----—---—-—--—---—---—---—--—------—-—-—-——-1- ---- ----- +--+ +--+ - 7 
| | 
a a a ee ee eee 
HEADING (5 bytes) One heading per buffer 5 Zoned Decimal 
| 7 6 A Type Data 
A (2 bytes) Offset from the start of the 7 Y Type Data 
Section Definition for the last byte 8 S Type Data 
defined in this buffer 9 V Type Data 
A B Type Data 
IND (1 byte) Indicator for last buffer B Instruction 
FF = More SYMS for this Section Defi- Cc CCW 
nition D Space 
00 = No more SYMS for this Section Bit 4 zero if label present 
Definition 3 One if label not present 
Bits 5-6 Duplication 
00 No Duplication, not 
VARIABLE LENGTH ENTRY (variable) One entry cluster subfield 
per named or data defining statement 01 Cluster subfield 
10 Duplication, no cluster 
LE (i byte) Length of this entry ii Duplication, with clust- 
| | er subfields 
A (2 bytes) Offset from the start of the Bit 7 Zero if no scaling 
Section Definition of the first byte One if scaling 
described by this entry 
OR (1 byte) Organization | LD (2 bytes) Explicit length of data field 
Bits 0-3 Format ? 
0 Character SYM (0 or 8 bytes) Label 
1 Hex | 
2 Fixed Point  M (0 or 3 bytes) Duplication factor 
3 Floating Point 
4 Packed Decimal S (0 or 2 bytes) Scaling 
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a. 


REFERENCE TABLE ENTRY 


LA (3 bytes) Loaded address of displaced 
instruction 


I (2 bytes) Displaced instruction 


SEG (1 byte) Overlay segment number con- 
taining TESTRAN SVC 
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APPENDIX D: 


TESTRAN EDITOR INPUT RECORD FORMATS 


This appendix contains diagrams of the organization of the 21 record types generated 


by the TESTRAN interpreter and processed by the TESTRAN editor. 


prologue 
separately for each record type. 


PROLOGUE RECORD 


The presentation for the 


record of the record pairs is generalized, while the data records are presented 


t 


CT ee en ae ee he er ee Seaman ase Candee neat 


| ID | NO| TIP | F | J 


1 
Cc | SA | L | A | M | VU Jj R | 


a a a a i 8 pean i an one oe ow AL Sa cme cate Oe ames | i on ae ow ew eo J 


ID (1 byte) Record Identification 
00000000 Skip this record 
00000010 TESTRAN 


NO (1 byte) For Type 5E records - TIA table 
| identification number 
For Type 5A records - 
Or Zero 
For Types 22, 26, 2A records 
Bit 0 = 0 - Normal trace record 
1 - Trace start record 
For Type 1E records 
04 = DCB 
08 = DEB 
OC = TCB, where 
Bit 0 = 0 - No floating point 
registers 
1 - floating point 
included 


Segment number 


T (1 byte) Type of Entry in D field (See 

note below) 
06 DUMP DATA 
OA TEST OPEN 
OE DUMP CHANGES 
12 DUMP MAP 
16 DUMP PANEL 

_ 1A DUMP COMMENT 
1E DUMP TABLE 
22 TRACE CALL 
26 TRACE REFER 
2A TRACE FLOW 
2E TRACE STOP 
32 TEST CLOSE 
36 ERROR 
42 Continuation 
46 Message 
4A CESD 
4E Map Change 
52 CSECT Relocation Table 
56 Symbol Table 
5A Reference Table 
5E TIA Table 


Note: Bit 7 in the T byte, if one, 


indicates that the current Data Record is 
continued in the next Data Record. 
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P (1 byte) TESTRAN Output Selection Code 
(8 bits, left to right, indicate out- 
put selections 1-8 respectively) 


F (4 bytes) where 
Byte 0 - Action Table ID number of 
Action Statement 
Bytes 1-3 - Address 
(null if no AT) 


of AT statement 


J (8 bytes) Name of load module 
C (1 byte) Number of M fields 


SA (3 bytes) | 
Absolute starting address of data for 
06, OE, 1E or TIA Table in Type 5A, 5E 
records 
Ignored for all other entry types 


L (2 bytes) | 
Length of Data Field (bytes) including 
continuations 
Exception: Trace with continuation. 


In this case, the length is for the 
current Data Record only. 


A (2 bytes) Current Action Pointer 
Byte 0 - Action Table ID Number 
Byte 1 - Macro Number 


M (2 bytes) Executed Statement Pointer 
Byte 0 - Action Table ID number 
Byte 1 - Macro Number 
The M fields 


the executed TESTRAN statements prior 
to the action which resulted in this 
output record. 


Note: The data record for asynchronous 
trace output starts in the third byte of 
the M field and is continued in the Data 
Record. There are no TESTRAN' executed 
statements associated with asynchronous 
trace output. This minimizes continuation 
in Trace Refer. 


provide the ability to. 
supply the programmer with a trace of. 


a. 


U (14 bytes) Not used 
Regardless of the number of M fields, 
this field always starts with byte 85 


(offset from beginning of record by 84 


bytes). 


M FIELD EXPANSION 


SST RIESE TSEERIIE EEuninERER SIR REnEREETRRRERERRET ERIE RRR EE REERERRERRERRIORR 


cr T T 
TRACE FLOW |A0{A1{A2| R 
L i i 


a a cic i a se ees 


AO (2 bytes) Not used 


Ai (4 bytes) From Address (absolute) 
A2 (4 bytes) To Address (absolute) 
R (64 bytes) General Registers 1 thru 0 


I (8 bytes) Active Branch Instruction 


c T T T 
TRACE REFER|A0|A1|A2| 
L 


cc I cs an a ee ence a tae 


AO (2 bytes) Not used 


A1 (4 bytes) Referencing Location 
(absolute) 
A2 (4 bytes) Referencing Location 


(absolute) 


R (64 bytes) General Registers 1 thru 0 


| gto poor 
TRACE CALL |AQ]A1|A2| 


behets 


AO (2 bytes) Not used 


A1l (4 bytes) From Address (absolute) 


Appendix 


R (4 bytes) 


Contents of the base register for 
DSECT, used in DUMP DATA and DUMP 


CHANGES. | 


St Ec a ngs sca a a a ee +--1T--1{-~ 
| I [E |EL|cc| 
eerie one eee Eee nee eer ee cena: (Yao! DOR Aas LETS 
E (4 bytes) Execute Instruction 
(null if not present) 
EL (4 bytes) Location of execute instruc- 
tion (absolute) | 
(not present if E is null) 
cc (4 bytes) Program Status Word 
PSS Pe eee ae ee ee 5 ae Seca Coma 
R [I |E |EL| 
a al tae acetate 5 Genel Gene! Een 


I (8 bytes) Referencing Instruction 


E (4 bytes) Execution instruction 
(null, if not executed) 


EL cs bytes) Location of execute instruc- 
tion (absolute) 
(not present if E is null) 


ee ee ee Pe ee gn eh re ea eee ee ee ae ee ee eee a ee ne ge et eae en et eee ee 1 
R | | 
Ba se aN J 


A2 (4 bytes) To Address (absolute) 


R (64 bytes) General Registers 1 thru 0 
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DATA RECORD 
c 
TRACE FLOW | X | | 


X (16 bytes) Padded Dummy Record 
(All data in M field of Prologue) 


r 
TRACE REFER| Cc | | 
L 


C (variable) Referenced Data 
Contents of referenced location before 
reference (256 bytes maximum). The C 
field in the next Sequential Data 
Record will contain the contents of 
the referenced location after ref- 
erence. | 


: | 
TRACE CALL | X | 


X (16 bytes) Padded dummy record 
(All data in M field of Prologue) 


- 
DUMP MAP lc | TI N 


C (1 byte) N (8 bytes) Name of Task 
Number of T, N, Al, A2, fields in the 
Data Record 
Al (4 bytes) Beginning actual address o 
area to be mapped 
T (1 byte) Type Area 


01 = Program area A2 (4 bytes) Ending actual address of area 

O02 = Data area to be mapped 
fa a ee ee ; cee? Gace 
TRACE STOP | T [| M | 1c | M | 
ea Re EON pene P et ee Se nee Me een tet D ASPET Ara MON NO CA mE EA, ER eRe Sn ee OE EERE aes Dee | 


T (1 byte) Action ID of action stopped 


M (1 byte) Macro ID of action stopped 
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DUMP DATA  ,--------------------------------------------------------- 


Pee ae ee 1 
DUMP CHANGES | B | | 
Ga es ea ce a alg hea he ae es J 
B (variable) Dumped Data 
The starting address of the Dump is 
found in the SA field of the prologue 
record. 
a a a a ca a a a a aaa dg 1 
DUMP PANEL | | GR / | | 
ee pee ee en aR COONS Oo goer, ee aE eee en a ioe sas Oe re oe J 
GR (64 bytes) General Registers 0-15 
PSW (8 bytes) Program status word 
FR (32 bytes) Floating point registers 0-7 
(Will not be present if file was 
generated on system with no floating 
point option.) 
a A a a Ra ir 1 
DUMP TABLE | | TD | 
Bs a a ea ee ee J 
TD (variable) Contents of table. 
The table ID is found in the NO field 
in the prologue record. 
ES Oe ee gers ee tt grees a gE Ew ee ge Te ee Se Fe EE OE eee A Se we a 1 
DUMP COMMENT | ; Xx | 
| ah NN he J 
X (16 bytes) Padded Dummy Record 
ee ne ee ee eG ee ee ee ne ee ee ee ee ee ee 7 
TEST OPEN | x | 
Be a ae a ee ee J 
X (16 bytes) Padded dummy record 
a a ee ee ee ee eee = 
TEST CLOSE | N1 | N2 |] N3 | Nn | 
2 i Ns a ee eee J 
N (1 byte) Number of Action Table closed 
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ERROR T 
Message j ID | C 
L 


ID (2 bytes) Message ID Number 


C (2 bytes) Count of characters in V field. 
If 128 or greater, the V field must be 


converted to Hex; otherwise, it is 
converted to decimal. 


edited. If bit 9=1, the V field is V (variable) Characters to add to message 
; a ee et Pg a ce eee ge eg ate I eT EGG CE ee eee See te ee eee 1 
Continuation | C | 
a a ae J 
C (variable) Continuation of previous Data 
Record 
Relocation CSS Se SS SS SS 2S5255 43 S4-SF= aaa a a SS SS SSS = 1 
Table | R1 | R2 | R3 | Rn | 
ee eee a oe a Me ete ee Ase eee eee ee a 
R (4 bytes) Relocated Address Scatter Load 
A 4 byte relocated address for each 
Block Load respective control section of this 
One 4 byte relocated address linked module. 
(indicates this relocation factor is 
applied to all control sections of 
this linked module). 
Reference pa at a a 4 
Table | TR | 
a a a th J 
TR (variable) Reference Table 
(See Appendix B for detail.) 
TIA pa ee oe ee ei eee ee ee eee 4 
Table { TA | 
i ee ee as ee a J 


TA (variable) TIA Table 
(See Appendix A for detail.) 
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ao 


. 
CESD | H | E1 
i 


H (8 bytes) Header - Ignored 


E (16 bytes) CESD entry 


Bytes 0-7 Control Section Name 
Byte 8 ESD Type 


Map r----------------- 7-------------- 


CHANGE | S1 | S2 


S (4 bytes) Overlay Segment Indicator 


Bit 0-30 Ignored 
Bit 31 If zero, segment is in storage 
and iS active. 


A (4 bytes) Header 


Bytes 0-2 Not Used 
Byte 3 Byte Count on 
record (240 bytes max.) 


remainder of 


B (80 bytes) Card Images (3 maximum) 


Byte 0 Hex 02 
Bytes 1-3 Characters SYM 


Bytes 9-11 Linkage Edited Address 
Byte 12 Segment Number | 
Bytes 13-15 Control Section Length 


Note: Each 4 byte entry occurs in numer- 


ical sequence. | 


Bytes 4-9 Not Used 

Bytes 10-11 Byte count of text in this 
card image 

Bytes 16-71 Symbol Table text 

Bytes 72-79 Not Used 


Note: Bytes 16-71 of the B field (Symbol 
Table Text) are further described as fol- 
lows: 
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Symbol fan ee Oe eS ee aaa ae ae ea as ee ee ota ee ee eons 5 eae rae a. 
Table | OR | AA l SYM 


Text a i i a a ee ee Se ee eee Ie ea cei J 


OR (1 byte) Organization Byte 


Bit 0 - If 0, not Data Type. Bits 1-3 
indicate the following: 


Bits 1-3 000 Space 
001 Control Section 
010 Dummy Control 
Section 
011 Common 
100 Instruction 
101 Command Control 
Word 
110 Not Used 
111 Not Used 
- If 1, Data Type. Bits 1-3 
indicate the following: 





Bit 1 | 
If 0, no duplication 
If 1, duplication 
(indicates presence of M 
field) : 


Bit 2 

If bit 1=0 
0 indicates independent 
1 indicates cluster 

subfield 

Tf bit 1=1 
0 indicates independent 
1 indicates cluster 


Bit. 3 
If 0, no scaling 
If 1, scaling (indicates 
presence of S field) 
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Bit 4 - If 0, label present 


If 


1, label not present 


Bits 5-7 Length of label minus one 


AA (3 bytes) 
Control Section 


Displacement from base of 


SYM (0-8 bytes) Symbol 


F (1 byte) Format 


00 
04 
08 


ID (1 byte) 
s i) 


e 


= 39 


Minu 


Charac 
Hex 

B Type 
Not Us 


ter 


Data 
ed 


Fixed Point, Full 


Fixed 
Floati 
Floati 
A Type 
Y Type 
S Type 
V Type 
Packed 


Point, Half 

ng Point, Short 
ng Point, Long 
Data 

Data 

Data 

Data 

Decimal 


zoned Decimal 


If the fo 
ter, binary, or hex, the LD field will 
be two bytes. 


Data Length (actual length 


rmat of the data is charac- 


M (3 bytes) Duplication factor 


S (2 bytes) Scaling 


eS 


function of each item. 


ROUTINE 


DUMP 


~ GO 


HBADDRSR 
HQOUTPUT 


IGCOOO4T 


IGC0106A 
IGCO038 © 
LEGMC00A 
IEGMEOOA 


. LEGMGOOA 


IEGNAOOA 
IEGNDOOA 


~IEGNGOOA 


ILEGNMOOA 


~ IEGNPOOA 


IEGNSOOA 


IEGNVOOA 


LTEGNYOO0A 
IEGOPEN2 
IEGOPEN3 
ITEGPAOO0A 
IEGPEOOA 


IEGPEDIT | 
IEGPGOOA 
_IEGPHOOA 
IEGPIOOA 


IEGPKOOA 
IEGPPOOA 
IEGRAOOA 


IEGRCOOA 


IEGREOOA 
IEGRFOOA 


_ IEGRGOOA 
_ IEGRKOOA 


IEGRLOOA 


 IEGSFOOA 
IEGSNOOA 


IEGSPOOA 


- ITEGSQOOA 


IEGSROOA 
IEGSU01Z 
IEGSU06Z 
IEGSU4 02 


ITEGSU50Z © 
_IEGSU60Z 


LTEGSU702Z 
ITEGSU80Z 
IEGSU90Z 


| FLOWCHART | PROGRAM | 
| 13-A1 | | | 
| 12-A1 | | | 
34-A2 INTERPRETER | 
34-A5 | INTERPRETER | 
31-A2 | INTERPRETER | 
30-A2 | INTERPRETER | 
30-A5 | INTERPRETER | 
50-A2 | EDITOR 
50-E4 = || EDITOR | 
54-A2 EDITOR | 
61-A3 | EDITOR | | 
62-A2 | EDITOR | 
59-A2~—s | EDITOR | 
59-H1i ss | EDITOR | 
59-FH = | | EDITOR 
55-c1 EDITOR | 
60-A1i | EDITOR | 
55-A4 EDITOR | 
32-A2—si| INTERPRETER | 
32-A4 | INTERPRETER | _ 
59-A5 | EDITOR | 
53-A1_ | EDITOR | 
51-A2 EDITOR l 
61-A5—_—i| EDITOR { 
53-A3 | EDITOR | 
53-E4 | EDITOR | 
(53-F2 | EDITOR i 
61-A1 | EDITOR | 
53-A5 ss EDITOR | 
S4-AG } EDITOR | 
52-A3 | EDITOR | 
55-A2 |: EDITOR . | | 
58-A5 {| EDITOR | 
52-E5 || EDITOR | 
52-F2 | EDITOR | 
51-A4 | EDITOR | 
64-A1 | EDITOR. | 
S57-A3 | EDITOR | 
64-A4 Jo. . EDITOR | 
65-A2 I EDITOR | 
66-C2 si EDITOR | 
 66-G1 _ EDITOR | 
-66-C5 | EDITOR | 
67-Al. | EDITOR | 
66-A4 si EDITOR | 
66-A1l.—s || EDITOR | 
51-E3 | EDITOR | 
67-A3 |. EDITOR | 


coum Ge cUmeme Guemet ees @enmee Gum Geer quad Gane Gae Gun gene ae wee Gee Gee eee Geet eee Gee Gee ee eee oReee eee eee Gee eee eee cewe Cee eee Gee EE ew OEee Gee Ce Ge Ee ee ewe Oe ee eee 
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- This appendix lists all TESTRAN routines by their symbolic names and all TESTRAN macro 
instructions by name. 


It gives the flowchart reference for each item and names the © 


re at cc em ee ee ere em a ce eae cee ae eee NE SD oa SD ce mS 


Appendix E: 


A routine whose name is preceded by an asterisk contains message text. 


MACRO- DEFINITION 
MACRO-DEFINITION 
ROUTER SUBROUTINE 
ROUTER SUBROUTINE 
TTOPEN1 SVC 49 
SAVE 

RESIDENT SVC 
START 7 
EDITOR ROUTER 
ACTION ROUTER 
DUMP DATA | 
DUMP CHANGES 

DUMP MAP 

DUMP COMMENT 

DUMP TABLE 
SYMBOL TABLE INITIALIZER 


TRACE 


SYMBOL TABLE, FIRST PASS 
TTOPEN2 COPY | 
TTOPEN3 OPEN 

TRACE STCP _ 

INVALID RECORD 

PANEL EDIT 

TEST OPEN 


TEST CLOSE 


INTERPRETER MESSAGE 
END OF RUN- eu 
DUMP PANEL 

CESD MAP 

MAP CHANGE 
RELOCATION TABLE 
SYMBOL TABLE BASE 
SYMBOL TABLE, ESD@S 
REFERENCE TABLE 
ACTION TABLE 

EDITOR MESSAGE 
ADDRESS ANALYZER | 
SYMBOL TABLE, LAST PASS 
SYMBOL SEARCH 
ATTRIBUTE ANALYZER 
EDIT, HEX 

EDIT, INSTRUCTION 
EDIT, ALPHAMERIC 
EDIT, BINARY 

EDIT, ZONED DECIMAL 
EDIT, PACKED DECIMAL 
EDIT, FIXED POINT 
EDIT, FLOATING POINT 


TESTRAN Flowchart Cross Reference List 





Se a IR ah a a a a nn Ae ey ee te 
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rr a a ne pe eee ge Me ee ee es Lee POR Ee gt een ae Te ee ee Ng ee et A ee ee ae ep ee oT ee eT ee 


| | ROUTINE ~= | # FLOWCHART | PROGRAM | FUNCTION | 
(a 
| IEGTTRNA } 4O-A1 | INTERPRETER | DUMP DATA 

| IEGTTRNB | 4O-H2 i INTERPRETER | DUMP COMMENT 

| IEGTTRNC { 40-H1 | INTERPRETER | DUMP PANEL 

| IEGTTRND ] 4O-AK j INTERPRETER | GO IN/OUT/TO 

| IEGTTRNE | 36-A4 | INTERPRETER | TEST ON 

] IEGTTRNF | 31-A4 | INTERPRETER | DUMP TABLE 

i IEGTTRNG | 37-A1 | INTERPRETER a TEST WHEN 

| IEGTTRNH | 39-A1 1 INTERPRETER | TEST CLOSE 

| IEGTTRNI | 41-A2 ; INTERPRETER ] GO BACK 

| IEGTTRNK | | 4O-F4 | INTERPRETER | DUMP MAP 

| IEGTTRNL | 37-A3.—ss| INTERPRETER | TRACE START 

| IEGTTRNM | 37-A4u | INTERPRETER | TRACE STOP 

| IEGTTRNN | 42-A4 | INTERPRETER | SET COUNTER 

| IEGTTRNO | 35-A2 | INTERPRETER | OVERLAY 1 

| IEGTTRNP | 42-A2 { INTERPRETER [ SET FLAG 

| IEGTTRNR | 39-Au | INTERPRETER | SET VARIABLE 

| IEGTTRNI | 43-A1 | INTERPRETER | TRACER 

| IEGTTRNX | 36-A2 | INTERPRETER I OVERLAY 2 

| IEGTTRNZ | 38-A2 | INTERPRETER | TRACE INTERRUPT 

| IEGTTROT | 33-A2 | INTERPRETER | ROUTER 

{ ‘JAMACHCK | 43-H1 | INTERPRETER | MACHINE CHECK INTERRUPT 

| JAPROGCK | 43-H2 | ©. INTERPRETER | PROGRAM CHECK INTERRUPT 

| SET | 11-A1 | | MACRO-DEFINITION | 

| TEST | 10-A2 | | MACRO-DEFINITION | 

| TRACE | 15-A1 | [° MACRO- DEFINITION 

Oe a ee ca ii i a a i Mi i ae ce he lca il il a a a eo 
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appendix lists 


identified with the appendix and page on which it is presented. 
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CONTROL BLOCK, RECORD 


ACTION TABLE 

ACTION TABLE LIST 

CONTROL CORE 

COUNTER TABLE 

DATA INPUT, CESD 

DATA INPUT, CONTINUATION 
DATA INPUT, DUMP CHANGES 
DATA INPUT, DUMP COMMENT 
DATA INPUT, DUMP DATA 
DATA INPUT, DUMP MAP 

DATA INPUT, DUMP PANEL 
DATA INPUT, DUMP TABLE 
DATA INPUT, ERROR MESSAGE 
DATA INPUT, MAP CHANGE 
DATA INPUT, REFERENCE TABLE 
DATA INPUT, RELOCATION TABLE 
DATA INPUT, SYMBOL TABLE 
DATA INPUT, TEST CLOSE 
DATA INPUT, TEST OPEN 
DATA INPUT, TIA TABLE 

DATA INPUT, TRACE CALL 
DATA INPUT, TRACE REFER 
DATA INPUT, TRACE STOP 
DATA INPUT, TRACE FLOW 
DCB/REL CORE 

DUMP CHANGE LIST 

DUMP CHANGE TABLE 

FLAG TABLE 

MAP 

PROLOGUE INPUT, TRACE FLOW 
PROLOGUE INPUT, TRACE REFER 
PROLOGUE INPUT, TRACE CALL 
REFERENCE TABLE 

REFERENCE TABLE 

SYMBOL TABLE 

SUBROUTINE TABLE 

TABLE CORE 

TABLE DICTIONARY 

TIA TABLE, A’ FIELD. 

TIA TABLE, DUMP CHANGES 
TIA TABLE, DUMP COMMENT 
TIA TABLE, DUMP DATA 

TIA TABLE, DUMP MAP 

TIA TABLE, DUMP PANEL 

TIA TABLE, DUMP TABLE 

TIA TABLE, GO BACK 


TIA TABLE, GO IN 


TIA TABLE, GO OUT 
TIA TABLE, GO TO 


Appendix Fs 


EDITOR 
EDITOR 
INTERPRETER 
INTERPRETER 
EDITOR 
EDITOR 
EDITOR 
EDITOR 
EDITOR 
EDITOR 
EDITOR 
EDITOR 
EDITOR 
EDITOR 
EDITOR 
EDITOR 
EDITOR 
EDITOR 
EDITOR 
EDITOR 
EDITOR 
EDITOR 
EDITOR 
EDITOR 
INTERPRETER 
EDITOR 
EDITOR 

_ INTERPRETER 
EDITOR 
EDITOR 
EDITOR 
EDITOR 
EDITOR 
INTERPRETER 
EDITOR 
INTERPRETER 
INTERPRETER 
EDITOR | 
INTERPRETER 
INTERPRETER 
INTERPRETER 
INTERPRETER 
INTERPRETER 
INTERPRETER 
INTERPRETER 
INTERPRETER 
INTERPRETER 
INTERPRETER 
INTERPRETER 


all of TESTRAN's control blocks and record formats. 
Listed is identified with the portion of TESTRAN which uses or processes it. 


a eH 


Each item 
It is also 
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ee ces OC fee re | 
i CONTROL BLOCK, RECORD | PROGRAM APPENDIX | 
| | | | | 
Sapa e= gc tis weaegire = ova aor siccase Tiel eae RTE aa perenne wae SRR eta anon { 
TIA TABLE, TEST AT | INTERPRETER | A- Pg. 89 | 
| TIA TABLE, TEST CLOSE | INTERPRETER | A- Pg. 90 | 
| TIA TABLE, TEST DEFINE COUNTER | INTERPRETER A- Pg. 91 | 
| TIA TABLE, TEST DEFINE FLAG | INTERPRETER | A- Pg. 91 | 
| TIA TABLE, TEST ON © { INTERPRETER | A- Pg. 92 | 
| TIA TABLE, TEST OPEN | INTERPRETER © | A - Pg. 90 | 
| TIA TABLE, TEST WHEN | INTERPRETER | A- Pg. 93 | 
| TIA TABLE, TRACE CALL | INTERPRETER | A- Pg. 88 | 
| TIA TABLE, TRACE FLOW | INTERPRETER | A- Pg. 88 | 
| TIA TABLE, TRACE REFER | INTERPRETER | A- Pg. 87 | 
| TIA TABLE, TRACE STOP | INTERPRETER | A- Pg. 89 | 
| TIA TABLE, SET COUNTER | INTERPRETER | A- Pg. 93 | 
| TIA TABLE, SET FLAG | INTERPRETER | A- Pg. 94 | 
| TIA TABLE, SET VARIABLE { INTERPRETER | A- Pg. 94 | 
| TRACE CORE | INTERPRETER | B- Pg. 99 | 
| TRACE TABLE { INTERPRETER | B - Pg. 101 | 
ete te a a aes ea as Se es Se a ee eS ese a Se ee eee eee 
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Abend 19,20,23,25 
Address analyzer routine 35-37 
Alphameric edit routine 38-39 
Analyzer (see Address, Attribute) 
Assembler 7,11,13,14,16,17,29 
Assembler tables, use of 16,29 
Attribute analyzer routine 36-38 
Attributes ? 

data 37,38 

overriders 37 

pointers 38 

test 16 


Binary edit routine 38 

Binary number conversion 39 | | 
BSAM, editor interface with 31,32 
BSAM, interpreter interface with 16 
Buffer, current print 31,32,35,36 
Buffer, editor action table 30,34 
Buffer, prologue 16,19 | 
Buffer, symbol table 31 

Buffer TTOPEN2 i18 


Checksum 18,19 | 

Comment (see dump comment) 
Configuration 32,36 

Constant 11 | 
Continuation record 32,38,39 

Control core 16,18, 22,24 

Control flow 7-20 

Control flow in sample program 26 
Control section relocation table 29,33 
Control table 18,20,23 | 
Counters 21,23 

CSECT 11,16,17,27, 34, 37 


Data, common 11,13,14 
Data record 16,26 
Data modes. 21 
Data set ! 
editor output SYSPRINT 9,29,31,36,37 
interpreter output, editor input 
 SYSTEST 8,9,15,18,26,27,29,31 ... 
Data, test output 7-9,11,15,17,19,29 
DCB (data control block) 16,18,26 
DEB (data extent block) 16,26. © 
Decimal instructions on the Model 91 26 
Dictionary, ESD, CESD 9,16, 27,29,34 
Dictionary, table 30 
Dump change list 30 
Dump change table 30 


Dump macro-instruction 11,14,16,21, 25,30 


Dump routines, editor 
dump changes 36 
dump comment 35 
dump data 36 
‘dump map 36 
dump panel 37 
dump table 35 
Dump routines, interpreter 
dump comment 26 
dump data, dump changes 25 
dump map 26 


INDEX 


dump panel 26 
dump table 26 
Duplication factor 37 


EBCDIC 38. 


Edit routine 38 
Edit, sample 39 
Editor, linkage 8,9,11,16,17, 29,33 


Editor message routine 32 


Editor router routine 32 
Editor tables 29-35 

Editor, TESTRAN 7-9,18, 26,29 
End statement overrider 17 


Entry, directory 16 


Entry point 8,17 

Entry positional operand 17 

Entry statement 17 

Entry, TIA table 7, 8, 11, 16- 28 
Entry, trace table 24 

Execute (EXEC) statement 9 
Execution, problem program/TIA 26 
Extent (See DEB) 


Fixed point edit routine 39 
Flag, load module test 16 
Flag table 18, 20, 23 _ 


Floating point edit routine 39 


Flowchart cross reference 121 
Flowcharts 42-79 : 
Format, conversion 38 

Format, printed ouput 38 
Format, SYM record 9 : 

Format, TIA entries 13 


Generations, system (SYSGEN) 7,11,13 
GO back, dummy 22 

GO BACK macro-instruction 7,8 

GO back routine 15,19,21-28 

GO (IN, OUT, TO) tout ine 22 


HBADDSR routine 19 
Hexadecimal edit routine 38 
HQOUTPUT routine i19 


Image instruction 38 
Image, storage 36,37 


Inactive 
CSECT 33 
segment 18 
tables 20 


Instruction, displaced 8,18, 22, 23, 28, 31, 38 
Instruction edit routine 38 

Instruction, inserted SVC 
8,16,19, 22, 23, 26,28,38 | 

Interface, BSAM 16,32 

Interface, I/O 31,32 

Interpreter action table (see TIA) 
Interpreter, composition of 15 

Interpreter logic flow 27 | 

Interpreter message routine 34,35 
Interpreter, operation of 8 

Interruption, TESTRAN SVC 8,11,16,17, 26,28 

Invalid record routine 33 
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Job control language 9,31 
Job steps 7-9,29,39 


Key, storage protect 24 


Link library 29 

Link/load mode 17,18 

Link macro-instruction 
7,15,18, 20-27, 29, 33,34, 37 
Linkage editor (see editor) 

Load (see link/load) 

Load macro-instruction 31,33 

Load module 8,9,11,16,17, 26,29, 34 


Macro-definition 

DUMP 14 

GO 14 

SET 14 

TEST 13 

TRACE 14. 
Map, editor storage 9,18,20,26, 29-37 
Mask, register selection 37 | 
Message identification 35 
Model 91 modifications 26 
Modifier fields (11,82 


Module 
load 8,9,11,16,17,26,29, 34 
object 9 


root 29,31, 32, 36- 38 
source 17 


Operator, comparison 21 
Organization, editor 29 

Output record pair 19,24,25,26,35 
Output routines 34,35 

Output selection code 8,9,35 
Overflow 32 

Overlay 16-19, 25, 32, 33 

Overlay routines 20 

Overrider 38 


Parameter, test 8,9 

Pointer, VF 21,22,24 

‘Problem program 7-11,15-36, 39 
Processor, post 7-9,29 

Program check 20,25 

Program execution 7,9,19,30-32 
Program fetch 26 | 
Program status word (PSW) 19,23,26,37 
Prologue record 15,16,19,24- 26, 32, 35 
PSW (see program status word) 


Reference table 18-20, 22, 27, 29-32, 38,39 


Register selection mask 37 
Resident SVC routine 16,19, 22,23,27 
Return-to-TESTRAN | 
flag 26 
PSW 26 
. Root module 29,31,32,36-38 
Root segment 16,17, 20 
Router, action 32,34-37,39 
Router, editor 32-39 
Router, interpreter 8,15-28 


Save area 26 

Save routine. 9, 15-18, 26,27 
Scale modifier 39 

Section definition 30-34 | 
Service routines 8,15-23,26,29 
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Sequence of execution 16 

Set counter routine 23. 

Set flag routine 23 

Set macro-instruction 14,16,23 
Set variable routine 23 
Setup routines 15-17,20,23 
Storage map (see map) 
Subroutine table 22 
Supervisor call (see SVC) 
Supervisor, contents 16,26 
Supervisor, overlay 16,20,25 


Supervisor state 7,9,15,26-28 


Svc 7,8,11,15-20, 22-28, 38 
SYM (see symbol) 
Symbol search routine 37. 
Symbol table 9,16,18,27,29-32, 34,36-39 
Base routine 34 
ESD routine 34 
First pass routine 34 
Initializer routine 34 
Last pass routine 34 
Symbolic labels 9,19,29,32,33,35 
SYSGEN 7,11,13 | a 
SYSPRINT 9,31-37 


 SYSTEST 8, 9, 15,18-20, 22, 24-35, 39 


SYSUT1 31, 34 


Table (see symbol, trace, TIA, control 
core, flag, reference, counter, 
subroutine) : . 

Table core 18,19 

Table dictionary 30 

Task control block (TCB) 8,16, 26 

TCB (see task control block) 

Test action macro-instructions 11,16,19,24 

TEST AT macro-instruction 7,8,18,19, 32 

Test attribute 16,26 | 3 

Test close routine 21,22. 

Test close routine (editor) 36 

Test control macro-instructions 
11,16,19, 24 

TEST macro-definition 13 

TEST OPEN macro-instruction 7,8,11,27 

Test open routine (editor) 36 

Test open routines 9,16,17,20, 26,30 

Test output data (see data) 

Test when routine 21 

TESTRAN, definition of 7 


Text, message 32 


Text, problem program 9 

TIA table 7-13,16-33,36,37, 39 
Trace core 20, 22-24 

Trace interrupt routine 16,20,23, 26 
TRACE macro-definition 14 
TRACE macro-instruction 11,16 
Trace mode switch 20,23-25 
Trace routine (editor) 35 
Trace start routine 23,24 
Trace stop 20, 22,24, 26 

Trace stop routine (editor) 35 


Trace table 20,23,24 


Tracer routine 23,25,26 


 TTOPEN routines 17-19. 


Validity, TIA table 19 
VF pointer (see pointer) 


XCTL macro-instruction 
15,20, 21, 24-26, 29, 31, 33- 37, 39 
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